Chrome扩展调用chrome.downloads.download无下载动作也无报错如何解决

解决方案 #

• 补充主机权限声明
  多数场景下该问题是仅声明了downloads权限，遗漏了目标下载资源的域名访问权限导致的。请在manifest.json的permissions数组中添加你需要下载的域名匹配规则，测试阶段可以临时添加<all_urls>验证问题：

"permissions": ["downloads", "<all_urls>"]

如果后续仅需下载特定域名的资源，替换为对应域名规则即可，例如下载jquery资源可以写"https://code.jquery.com/*"。

• 捕获下载中断错误信息
  添加下载状态变更监听，获取潜在的中断原因，很多时候任务看似卡住实则已经被系统拦截中断，只是没有触发状态更新提示：

chrome.downloads.onChanged.addListener((delta) => {
  if (delta.state?.current === "interrupted") {
    console.log("下载中断原因：", delta.error);
  }
});

• 检查Chrome相关配置
  1. 打开Chrome的下载管理页chrome://downloads/，查看是否存在对应下载任务，确认是否被安全浏览功能拦截
  2. 进入对应扩展的管理详情页，确认「允许访问您访问的网站上的所有数据」权限已开启
  3. 检查Chrome默认下载目录的读写权限，确保Chrome有写入该目录的权限，可尝试手动修改默认下载目录到普通文件夹后重试
  4. 暂时关闭浏览器的增强型安全浏览功能、本地安全软件后重试，排除拦截类问题
• Manifest V3 版本特殊检查
  如果你使用的是Manifest V3版本的扩展，不要将下载逻辑放在popup页面执行：popup关闭后上下文会直接销毁，未完成的下载任务会被强制挂起。建议将下载逻辑迁移到后台service worker中执行。

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