You need to enable JavaScript to run this app.
优惠活动
大模型
产品
解决方案
定价
更多

Chrome加载自定义扩展报错“Service Worker注册失败,状态码10”是何原因?

Chrome扩展Manifest V3中Service Worker显示“Inactive”的排查与解决

我在Chrome中加载自定义Manifest V3扩展时,遇到Service Worker被标记为inactive的问题,即使尝试重置Chrome、更新浏览器、重装浏览器,甚至使用空的background.js或添加try/catch块,问题依然存在。

错误截图:
Service Worker Inactive错误截图

我的Manifest文件内容(已移除敏感路径):

{
    "name": "Quicker",
    "version": "1.0",
    "description": "Automation quick actions performer",
    "manifest_version": 3,
    "permissions": [
        "storage",
        "activeTab",
        "tabs",
        "notifications",
        "background",
        "management"
    ],
    "content_scripts": [
        {
            "matches": [
                "..."
            ],
            "js": [
                "jquery-3.4.1.min.js",
                "contentScript.js"
            ],
            "run_at": "document_end"
        },
        {
            "matches": [
                "..."
            ],
            "css": [
                "jenkinsStyle.css"
            ],
            "run_at": "document_end"
        }
    ],
    "action": {
        "default_popup": "popup.html"
    },
    "background": {
        "service_worker": "background.js"
    },
    "web_accessible_resources": [
        {
            "resources": [
                "..."
            ],
            "matches": [
                "<all_urls>"
            ]
        }
    ],
    "icons": {
        "128": "autoCog.png"
    }
}

排查与解决步骤

1. 修正Manifest权限配置

Manifest V3中已移除background权限声明,无需将其加入permissions数组,这会导致兼容性问题。修改后权限配置如下:

"permissions": [
    "storage",
    "activeTab",
    "tabs",
    "notifications",
    "management"
],

2. 验证Service Worker文件有效性

  • 确认background.js存在于扩展根目录,路径无拼写错误
  • 即使是空文件,也要确保无语法错误(如多余逗号、未闭合括号)

3. 主动触发Service Worker激活

Manifest V3的Service Worker为事件驱动,闲置时默认进入inactive状态是正常行为。若始终无法激活,可尝试:

  • 点击扩展图标触发action事件,或打开content script匹配的页面,观察Service Worker是否转为active
  • 在扩展管理页面的「Service Worker」栏点击「Inspect」,查看控制台是否有报错信息

4. 确认扩展加载规范

  • 若加载的是已解压扩展,修改文件后需点击扩展卡片的刷新按钮重新加载
  • 避免在未配置允许运行的隐身模式下测试

5. 检查Chrome版本兼容性

确保Chrome版本在92及以上(Manifest V3最低要求),可通过chrome://version/确认当前版本

内容的提问来源于stack exchange,提问作者user3673620

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.08.10 05:00:53