同一份前端包在 Chrome 100 正常，安卓 6 的 WebView 打开只有白屏，logcat 里报 Uncaught SyntaxError: Cannot use import statement outside a module，所有按钮都点不动。碰到这种情况，我一般先确认改动有没有真的生效。
原因不复杂，旧 WebView 不认识 script 的 type=module，把它当普通脚本执行，文件里还有 import 语法，解析阶段就失败。构建产物只出了 ESM 一份，没有给旧内核留 IIFE 版本。
「WebView 模块脚本」相关的日志我一般连着看前后五分钟，单看一条报错经常判断不出是哪一步失败。改完顺手把文档补一句，省得下次自己重新推一遍。
<script type='module' src='/app.esm.js'></script> <script nomodule src='/app.iife.js'></script>
监控和日志的时间要对上，时区不一致会多绕很大一圈。临时改动用注释写上日期和原因，过两周自己都记不清为什么这么写。
动手前把原文件复制一份带时间戳，出问题立刻换回去，比现场分析快得多。
具体做法是，构建同时产出 ESM 和 IIFE 两份 用 nomodule 兜底；旧内核加载 IIFE 版本 新内核继续走 module；script 标签补上 crossorigin 避免额外报错；在旧内核设备打开 确认白屏消失且按钮可用。
最后用这个标准收尾，旧内核设备加载 IIFE 版本后页面正常渲染，控制台没有 import 相关报错。