Tampermonkey 脚本失效问题解析：MutationEvent 弃用引发的兼容性问题

问题背景

近期，许多 Tampermonkey 用户在使用 Chrome Canary 或 Dev 版本时遭遇了一个严重问题：用户脚本突然停止工作。这个问题最初在 GitHub 上被报告，表现为 Tampermonkey 无法正确加载和执行用户脚本，甚至在某些情况下会报告"找不到脚本"的错误。

问题本质

经过技术分析，这个问题的根源在于 Chrome 浏览器对 MutationEvent 接口的逐步弃用。MutationEvent 是早期用于监听 DOM 变化的 API，包括 DOMSubtreeModified 等事件类型。根据 Chromium 团队的规划，这些 API 将在 Chrome 127 版本（预计2024年7月30日）中默认禁用。

技术细节

MutationEvent 接口存在几个关键问题：

1. 性能低下：每次 DOM 变化都会触发事件，导致大量不必要的回调
2. 同步执行：会阻塞主线程，影响页面响应速度
3. 已被更现代的 MutationObserver API 取代

Tampermonkey 的部分功能依赖于这些即将被移除的 API，因此在 Chrome 124+ 的测试版本中出现了兼容性问题。

影响范围

这个问题主要影响：

• Chrome Canary 124.0.6367.0 及以上版本
• Chrome Dev 125.0.6368.2 及以上版本
• 使用 Tampermonkey 5.1.0 版本的用户

解决方案

临时解决方案

1. 在 Chrome 地址栏输入 chrome://flags
2. 搜索"Enable (deprecated) synchronous mutation events"
3. 启用该选项
4. 重启浏览器

永久解决方案

Tampermonkey 团队已在测试版(5.1.6194)中修复此问题：

1. 下载测试版 CRX 文件
2. 打开 chrome://extensions 页面
3. 启用"开发者模式"
4. 将 CRX 文件拖拽到扩展页面进行安装

最佳实践建议

对于用户脚本开发者：

1. 避免在脚本中直接使用 MutationEvent
2. 改用 MutationObserver API 实现 DOM 变化监听
3. 及时更新脚本以适配浏览器新特性

对于普通用户：

1. 保持 Tampermonkey 扩展为最新版本
2. 考虑使用稳定版 Chrome 而非测试版
3. 定期备份用户脚本和设置

总结

这次事件展示了 Web 技术演进过程中可能遇到的兼容性挑战。随着浏览器不断更新和优化 API，扩展开发者需要及时跟进技术变化，而用户也需要理解这些底层变化可能带来的影响。Tampermonkey 团队已经快速响应并解决了这个问题，体现了对用户体验的重视。