Chrome扩展从应用商店安装后captureVisibleTab权限编码报错求助

问题重现 #

本地开发Chrome扩展时，使用chrome.tabs.captureVisibleTab()接口对特定网页截图，配置host_permissions: ["<all_urls>"]后运行正常，但从Chrome应用商店安装后抛出权限错误：

Error: Cannot access contents of the page. Extension manifest must request permission to access the respective host.

调试发现，商店下载的扩展文件中，host_permissions被异常修改为：

host_permissions: ["%3Call_urls>"]

左尖括号<被URL编码为%3C，导致Chrome无法识别该权限规则。

解决方案 #

1. 替换权限通配符写法
   将host_permissions中的<all_urls>替换为等价的通配符组合，避免尖括号引发的编码问题：

   "host_permissions": ["http://*/*", "https://*/*"]
   

   该写法与<all_urls>权限范围完全一致，且不会触发商店打包时的错误编码。

2. 验证本地打包并重新提交

   • 手动将本地扩展打包为CRX文件（Chrome开发者模式→打包扩展程序），解压后确认manifest.json中的host_permissions未被编码。
   • 重新上传验证后的扩展包至Chrome应用商店，确保上传的原始文件中manifest.json格式正确。

原因分析 #

Chrome应用商店的自动打包流程可能对尖括号<这类特殊字符进行了不必要的URL编码，导致%3Call_urls>无法被Chrome识别为合法的权限通配符，进而使chrome.tabs.captureVisibleTab()接口无法获取页面访问权限。

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