Firefox扩展后台脚本被预终止：当前标签打开URL时监听失效求助

核心问题定位 #

从控制台日志能直接看出：当在当前标签打开URL时，后台脚本被重启了——执行startListening打印added后，又出现了new RequestHandler日志，说明之前的RequestHandler实例被销毁，新实例重新创建，导致之前添加的监听器和待监听URL列表全部丢失，自然无法触发响应头修改逻辑。

当前标签导航触发脚本重启的核心原因，大概率是你的扩展使用了非持久化事件页面（manifest.json中background.persistent设为false），Firefox会在后台脚本无活跃事件时自动终止它。而当你在当前标签导航到带有attachment头的URL时，浏览器触发下载流程的瞬间，扩展后台的异步操作（browser.tabs.update）还未完成，脚本就被系统终止并重启了。

具体修复步骤 #

1. 确保后台脚本持久运行

在manifest.json中修改background配置，设置为持久化背景页，避免脚本被自动终止：

"background": {
  "scripts": ["background.js"],
  "persistent": true
}

注：虽然Firefox推荐使用非持久化事件页面，但对于需要持续监听webRequest的场景，持久化背景页能彻底避免脚本意外重启的问题。

2. 修复监听器重复添加的问题

当前startListening方法每次调用都会新增一个onHeadersReceived监听器，不仅会造成内存泄漏，还会导致逻辑混乱。应该将监听器的添加移到类的构造函数中，只初始化一次：

class RequestHandler {
    private readonly _urlsToListenFor: string[] = [];

    constructor() {
        // 仅初始化一次监听器
        browser.webRequest.onHeadersReceived.addListener(
            this.onHeadersReceived,
            {
                urls: ["*://*/*"],
                types: ["main_frame"]
            },
            ["responseHeaders", "blocking"]);
    }

    public startListening = (url: string) => {
        console.log("added");
        // 避免重复添加同一URL
        if (!this._urlsToListenFor.includes(url)) {
            this._urlsToListenFor.push(url);
        }
    };

    // 其余方法保持不变...
}

3. 优化URL匹配逻辑

当前使用indexOf匹配URL，可能存在精确匹配的局限性（比如URL带参数时无法匹配），可以改用更灵活的URL对象对比：

private onHeadersReceived = (details: browser.webRequest._OnHeadersReceivedDetails) => {
    const targetUrl = new URL(details.url);
    const listenerIndex = this._urlsToListenFor.findIndex(item => {
        const itemUrl = new URL(item);
        // 忽略参数差异，只匹配核心地址
        return itemUrl.origin + itemUrl.pathname === targetUrl.origin + targetUrl.pathname;
    });
    if (listenerIndex === -1) return;

    console.log("removed");
    this._urlsToListenFor.splice(listenerIndex, 1);

    return this.getBlockingResponse(details);
};

4. 调整tabs.update的参数（可选优化）

当在当前标签打开URL时，loadReplace设为false会添加新的历史记录，若不需要保留历史，可以设为true优化用户体验：

await browser.tabs.update(tab.id!, { url, loadReplace: !newTab });

验证修复效果 #

修改后测试两种场景：

• 新标签打开URL：依然正常触发监听器，移除响应头并显示内容
• 当前标签打开URL：后台脚本不再重启，监听器正常触发，内容在标签页显示而非下载

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