老安卓设备WebView内核陈旧（如Android 4.x系统WebView 37–44），需运行时检测、ES5/autoprefixer编译、核心API垫片、禁用grid、HTTPS全站化、降级Cordova/Capacitor插件、IndexedDB替代localStorage等多层兼容方案。
WebView内核太老导致HTML5特性不支持
很多老安卓设备（尤其是4.x系统）自带的WebView还是Android System WebView 37–44版本，连Promise、fetch、flexbox新语法都报错或渲染错乱。不能指望用户手动升级系统WebView——他们根本找不到入口。
- 必须在打包前做运行时检测：
navigator.userAgent里含Chrome/37或Version/4.0就大概率是旧内核 - 用
caniuse-lite+browserslist配置构建目标，强制编译出 ES5 + autoprefixer 兼容代码 - 关键API必须垫片：在入口JS顶部提前加载
core-js/stable和regenerator-runtime/runtime - 避免用
display: grid—— 老WebView对grid的支持是残缺的，flex也要加-webkit-前缀
Android 4.4以下无法加载HTTPS混合内容
老版WebView默认禁用HTTPS页面中加载HTTP资源（比如CDN上的JS/CSS），控制台只报net::ERR_CLEARTEXT_NOT_PERMITTED，但没提示具体哪个请求被拦了。
- 检查所有资源URL：图片、字体、AJAX接口、第三方SDK，确保全是
https://协议 - 如果后端API暂时无法切HTTPS，可在
AndroidManifest.xml里临时加android:usesCleartextTraffic="true"（仅限调试，上线前必须撤掉） - 真机测试别只看模拟器——某些厂商ROM（如早期华为EMUI）会额外拦截，得拿小米2S、三星S3这类真机跑一遍
Cordova/ Capacitor插件在低版本Android上初始化失败
Cordova 10+ 默认要求 Android 5.0+，capacitor-android 5.x 已放弃对 API 19 的支持。但你App的minSdkVersion设的是16，一启动就卡在白屏，logcat里只有java.lang.NoClassDefFoundError: android.webkit.WebViewClient这种模糊错误。
- 降级插件版本：用
cordova-android@8.1.0（支持API 19）或@capacitor/android@4.8.0 - 删掉插件里用了Java 8语法的模块（比如
Optional、Stream），改用Apache Commons Lang替代 - 在
config.xml里显式声明，避免老系统Activity栈异常 - 不要在
deviceready之前调用任何插件方法——老内核下事件触发时机不稳定，建议加100ms延时兜底
本地存储容量小且容易被系统清理
Android 4.x 的WebView对localStorage限额极低（常只有2MB），且当系统内存紧张时会静默清空，用户重启App后登录态丢失，以为是“闪退”。
立即学习“前端免费学习笔记（深入）”；
- 别把token、用户资料全塞
localStorage——改用IndexedDB（需localForage封装，自动fallback到WebSQL） - 敏感数据存
SharedPreferences（通过Cordova插件桥接），比Web存储更稳 - 每次写入前先用
localStorage.length和localStorage.key(0)检查是否已满，满则clear()并告警上报 - 上线前务必用
adb shell dumpsys diskstats确认设备剩余data分区空间，低于50MB时直接禁用离线缓存
WebView行为可能差出两个版本。 
