Chrome拒绝我的URL权限模式：Manifest报错如何解决？

错误原因 #

问题核心是Manifest版本适配错误：

• 若你使用Manifest V3，主机权限（URL路径规则）必须单独声明在host_permissions字段中，不能和tabs、storage这类API权限混放在permissions数组里。把URL模式放在错误的字段中，会被Chrome判定为无效权限，触发格式错误提示。
• 部分你尝试的URL模式本身不符合规范：比如直接使用带具体ID的完整URL（如https://www.dndbeyond.com/homebrew/creations/magic-items/2909810-ashandarei/edit），Chrome不允许用具体URL作为主机权限，必须用带通配符的模式匹配一类路径；冗余的多通配符模式（如*://*dndbeyond.com/homebrew/*）即使语法合法，放在错误字段里依然无效。

修复步骤 #

1. 确认Manifest版本
   检查manifest.json顶部的manifest_version字段：

   • 若值为3：必须将主机权限移至host_permissions数组。
   • 若值为2：可继续放在permissions中，但要保证URL模式语法正确。

2. 修正权限配置

   针对Manifest V3（推荐，Chrome已逐步淘汰V2） #

   修改manifest.json，新增host_permissions字段并迁移URL模式：

   {
     "manifest_version": 3,
     ...
     "permissions": [
       "tabs",
       "activeTab",
       "storage",
       "scripting"
     ],
     "host_permissions": [
       "*://www.dndbeyond.com/homebrew/*"
     ],
     ...
   }
   

   针对Manifest V2 #

   保留permissions数组，但使用更明确的协议模式（避免协议通配符的兼容问题）：

   {
     "manifest_version": 2,
     ...
     "permissions": [
       "tabs",
       "activeTab",
       "storage",
       "scripting",
       "https://www.dndbeyond.com/homebrew/*"
     ],
     ...
   }
   

3. 验证URL模式规范
   合法的主机权限URL模式需满足：

   • 必须包含协议（http:///https://等），或用<all_urls>匹配所有URL；
   • 通配符*仅能放在协议开头（如*://）、主机开头（如*.dndbeyond.com）或路径末尾（如/homebrew/*）；
   • 禁止使用具体完整URL，必须用通配符匹配一类路径。

常见误区提醒 #

• 不要混淆API权限（如tabs、storage）和主机权限（URL路径），V3中两者需分开声明；
• 避免过度使用通配符，比如*://*dndbeyond.com/homebrew/*可简化为*://www.dndbeyond.com/homebrew/*，更精准且符合规范；
• 若需匹配该域名下所有路径，使用*://www.dndbeyond.com/*即可。

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