Chrome扩展多content_script注入执行顺序异常问题求助

你确实错误假设了不同content_scripts组之间的注入顺序——Chrome不保证匹配同一页面的多组content_scripts的执行顺序，哪怕它们的run_at设置完全相同。

核心原因 #

Chrome对content_scripts的调度逻辑是：同一run_at时机下，多个匹配的脚本组的注入顺序是不确定的，可能受扩展缓存状态、Chrome启动后的内部调度优先级、甚至浏览器版本差异影响。你本地测试正常只是偶然触发了预期顺序，而用户重启浏览器后，Chrome的调度逻辑变化导致第二组脚本先被注入，这就出现了CONST is not defined的报错（因为basics.js还没执行，CONST还未定义）。

可行的解决办法 #

1. 合并脚本组，通过代码控制逻辑执行时机

这是最可靠的方案：把subpage.js加入第一组的js数组，然后在subpage.js开头添加页面判断逻辑，只有当前页面是子页面时才执行内部代码。

修改后的manifest.json片段：

"content_scripts": [
  {
    "matches": ["https://*.xxxxx.com/xxx/index.php*"],
    "js": ["purify.min.js", "basics.js", "main.js", "subpage.js"],
    "run_at": "document_start"
  }
]

subpage.js开头添加判断：

// 仅在子页面执行逻辑
if (!window.location.search.includes('?page=subpage')) {
  return;
}

// 原来的subpage.js代码逻辑
// ...

这样能保证所有脚本严格按照你定义的顺序执行，子页面的逻辑只会在basics.js之后触发。

2. 在subpage.js中添加等待逻辑（临时兼容方案）

如果不想修改manifest结构，可以在subpage.js中等待CONST定义完成后再执行逻辑，比如用定时器轮询：

function waitForConst() {
  if (typeof CONST !== 'undefined') {
    // 执行subpage逻辑
    initSubpage();
  } else {
    setTimeout(waitForConst, 10);
  }
}

waitForConst();

function initSubpage() {
  // 原来的subpage.js代码
}

这种方案是兜底手段，不如第一种稳定，因为轮询的时间间隔不好把控，极端情况下可能还是会出问题。

关键提醒 #

Chrome仅保证同一content_scripts组内的脚本按数组顺序执行，不同组之间的顺序完全不可靠，不要依赖这种不确定的行为来构建扩展逻辑。

内容的提问来源于stack exchange，提问作者Rivenscryr