遇到火狐浏览器中 Tampermonkey 脚本无法正常注入 DOM 节点的问题，根子往往出在触发时机过早、权限没开够，或者撞上了 Firefox 特有的内容脚本隔离策略。

不是所有页面在 DOMContentLoaded 之后就能随便操作元素的。尤其碰上 Shadow DOM、动态渲染框架（React/Vue）或是 document.write 重写页面的情况，往往会直接翻车。

确认脚本运行时机是否匹配页面实际结构

第一步：检查 DOM 是否就绪

打开开发者工具（Ctrl+Shift+I）→ 切到“控制台” → 输入 document.body，看返回的是不是 null。如果返回 null，说明脚本执行时 HTML 还没解析完，这时候注入啥都是白搭。

第二步：调整 @run-at 参数

在脚本元信息里把 @run-at 从默认的 document-idle 改成 document-end 或 document-start。保存后刷新页面。

需要留意的是：【@run-at document-start 会跳过 DOMContentLoaded 事件监听，只有需要劫持 document.write 或早期全局对象修改时才用得上】。

第三步：处理异步加载元素

如果目标元素是 Ja vaScript 异步加载的（比如分页列表、懒加载图片容器），那必须靠 MutationObserver 或轮询检测。不能指望一次 DOM 就绪事件就搞定。

检查 Firefox 扩展权限与站点隔离设置

基础权限检查

点一下地址栏左侧的扩展图标 → 点 Tampermonkey 图标 → 选“此网站的设置” → 确认“允许访问文件 URL”和“允许在此网站上运行”都已经打开。这一步虽然基础，但经常被忽略。

高级配置调整

接着进 about:config → 搜索 privacy.partition.network_state → 如果值是 true，临时改成 false。

Firefox 108+ 默认开启了网络状态分区，可能会干扰脚本读取 document.cookie 或 localStorage，进而影响 DOM 注入逻辑。

绕过 Shadow DOM 或框架虚拟 DOM 的注入方法

办法一：递归查找 shadowRoot

用 document.querySelector 搭配 shadowRoot 递归查找，从宿主元素往下摸。

办法二：强制等待渲染完成

在脚本开头塞下面这段代码，强制等渲染完成再执行主逻辑：

const waitForShadow = (hostSelector, timeout = 5000) => new Promise(resolve => { const check = () => { const host = document.querySelector(hostSelector); if (host && host.shadowRoot) return resolve(host.shadowRoot); if (timeout <= 0) return resolve(null); setTimeout(check, 100); timeout -= 100; }; check(); });

办法三：监听 SPA 路由变化

针对 Vue/React 这类 SPA 框架，监听 history.pushState 或 hashchange 事件。在路由切换后重新执行 DOM 查找。

说白了就是把这些监听逻辑直接塞进你的 main() 函数里，简单粗暴。

《夸克》非常好用的免费AI浏览器

下载APP查看