Tampermonkey MV3扩展在Edge浏览器中的脚本注入问题分析

Tampermonkey作为流行的用户脚本管理器，在Edge浏览器中使用MV3版本时可能会出现脚本注入不稳定的情况。本文将从技术角度分析这一现象的原因和解决方案。

问题现象

用户在使用Tampermonkey MV3版本时发现，相同的脚本集有时能够成功加载执行，有时却完全不会注入到页面中。相比之下，Legacy版本表现更为稳定可靠。

根本原因分析

经过技术排查，发现该问题主要涉及以下几个技术点：

1. 匹配模式问题：用户最初使用的@match *模式在MV3版本中不完全适用，正确的格式应为*://*/*。MV3版本对匹配模式的校验更为严格。

2. 事件监听时机：使用@grant none会禁用沙箱环境，此时window.addEventListener的行为与常规网页脚本一致，无法保证在DOMContentLoaded事件触发前完成注册。

3. 注入机制差异：MV3版本由于Chrome扩展架构的变化，脚本注入机制与Legacy版本有所不同，对执行时机的把控更为敏感。

解决方案

针对上述问题，建议采取以下解决方案：

1. 修正匹配模式：

// @match *://*/*

2. 优化脚本注入配置：

   • 在Tampermonkey设置中将"Config Mode"设为"Advanced"
   • 将"Content Script API"设为"UserScript API Dynamic"以加速注入

3. 完善脚本结构：

// ==UserScript==
// @name         Test
// @version      0
// @description  test
// @match        *://*/*
// @grant        none
// @run-at       document-start
// ==/UserScript==

console.log('脚本开始执行');
window.addEventListener('DOMContentLoaded', function() {
    console.log('DOM加载完成');
    document.body.insertAdjacentHTML('beforeend', `
        <div style="background-color: red; color: white; position: fixed; bottom: 0;">Test</div>
    `);
});

技术建议

1. 对于关键功能脚本，建议保留@grant声明以使用沙箱环境，确保事件监听可靠性。

2. 在脚本中加入调试日志，便于追踪执行流程和排查问题。

3. 考虑使用document-end而非document-start作为运行时机，除非确实需要在页面加载早期执行。

4. 定期检查Tampermonkey更新，MV3版本仍在持续优化中。

通过以上调整，可以显著提高Tampermonkey MV3在Edge浏览器中的脚本注入稳定性，确保用户脚本按预期执行。