在米侠浏览器中JS脚本运行报错该如何排查原因

米侠浏览器JS脚本报错需分五步排查：先确认报错来源是本地脚本还是网页自身；再依错误类型分层定位语法、引用或内存问题；接着验证脚本文件为小写.js、UTF-8无BOM、未压缩；然后检查注入开关开启、路径正确且手动刷新列表；最后用console.log验证@run-at时机是否生效。

在米侠浏览器中JS脚本运行报错，页面功能缺失、按钮不响应或控制台持续红字提示，说明脚本已加载但执行阶段失败，必须区分是语法错误、运行时异常还是资源冲突导致的中断，不能只看报错文字就盲目改代码。

第一步：确认报错来源是本地脚本而非网页本身

点击地址栏右侧“刷新”按钮旁的“开发者工具”图标（或按F12），切换到Console面板；若红字报错开头含 mixia://、file:///sdcard/ 或路径中含 scripts/ 字样，说明错误来自你安装的本地用户脚本；若报错指向 https://域名 下的JS文件，则问题在网页自身，无需修改你的脚本。

这一步跳过会直接误判方向——网页自身的语法错误无法通过改本地脚本修复，强行编辑反而破坏功能。

第二步：定位具体错误类型并分层排查

根据报错关键词快速归类：

SyntaxError：说明脚本存在非法字符、括号不匹配、分号遗漏或X5内核不支持的ES6+语法，需用纯文本编辑器检查BOM头/全角符号，以分段注释法缩小范围，并切换系统内核获取精准报错。

ReferenceError / TypeError：常见于变量未声明、DOM节点未找到、API不可用（如AbortController、ResizeObserver在X5内核中返回undefined），需检查@run-at时机是否过早、是否缺少polyfill垫片、是否误用现代语法。

RangeError / InternalError / Out of Memory：多由长循环未拆分、事件监听器未释放、setInterval未清除或DOM节点持续累积导致，需清理冗余资源并分批执行任务。

第三步：验证脚本文件是否符合硬性准入条件

第一步：检查文件扩展名是否为纯小写 .js —— 若是 .JS、.Js 或带空格（如“my script.js”），米侠浏览器会静默忽略，不报错也不显示。

第二步：用文件管理器长按该.js文件→「编辑」→全选粘贴到记事本类纯文本工具中查看：若开头出现乱码或隐藏BOM头（如 EF BB BF 字节），必须另存为UTF-8无BOM格式，否则解析失败。

第三步：确认脚本未被压缩包包裹——米侠不支持直接读取.zip/.rar内嵌的.js，必须解压到目录层级中，且若有 manifest.json，需与.js同级。

【务必保存为UTF-8无BOM格式】——用Notepad++选“编码→转为UTF-8无BOM”，VS Code右下角点击编码类型后选择“Save with Encoding→UTF-8”，否则重启浏览器后仍报错。

第四步：检查脚本注入总开关与路径扫描状态

① 点击右上角三个点→【设置】→【高级设置】→【脚本注入】→将“启用脚本注入”切换为开启状态。

② 重启浏览器后，再进入该页面确认开关右侧显示“已启用”，否则后续操作全部无效。

③ 安卓设备上，米侠浏览器仅扫描 /sdcard/MiXiaBrowser/scripts/ 路径中的.js文件；其他任何位置（如Download、Documents、根目录）均不会被自动发现。

④ 若该路径已存在但脚本仍未出现，重启浏览器后进入「设置→高级设置→脚本注入」页，点击右上角「刷新脚本列表」按钮——这一步不能跳过，否则浏览器不会重新扫描磁盘。

第五步：强制验证@run-at时机是否真正生效

方法一：在脚本开头插入调试语句

在return或主逻辑前加一行 console.log('run-at:', document.readyState, 'time:', Date.now());，保存后刷新目标网页。

方法二：打开开发者工具（地址栏输入 miaoxia://devtools），切换到Console标签页，观察输出时间戳和readyState值：

若看到 document-end 对应 readyState = 'complete' 且时间戳晚于页面DOMContentLoaded事件，则时机正确；

若 readyState = 'loading' 或时间戳早于页面首屏渲染，则仍处于 document-start 阶段，需检查参数拼写是否全小写、有无多余空格或换行。