Chrome开启下载询问保存位置时调用chrome.downloads.download中断问题

MV3（Manifest V3）扩展下chrome.downloads.download调用saveAs: true失败、开启全局「下载前询问每个文件的保存位置」后所有下载被中断报USER_CANCELED，是Service Worker后台上下文的固有行为限制，和filename参数配置无关：

• saveAs: true触发的「另存为」对话框、全局下载询问弹窗，都要求调用下载接口的执行上下文必须绑定可见的浏览器窗口，才能正常弹出系统级文件选择器。
• MV3的background运行在独立的Service Worker线程中，没有关联任何可见窗口，Chrome检测到调用来源不满足弹窗展示条件时，会直接取消下载，返回USER_CANCELED错误，不会弹出任何选择窗口。
• 全局开启下载位置询问时，所有下载请求都会强制触发弹窗校验，因此无论saveAs参数设置为true还是false，只要调用从Service Worker发起，都会被拦截中断。

方案1：将带saveAs的下载调用迁移到有可见上下文的环境执行 #

不要直接在background Service Worker中调用需要弹出保存对话框的下载逻辑，将触发逻辑转移到以下任意一个绑定可见窗口的上下文：

• 扩展的popup弹窗页、options设置页
• 注入到普通网页的content script
  如果需要从后台逻辑触发下载，可以通过消息通信把下载参数传递给上述上下文，再由对应上下文调用下载接口。
  示例：通过content script触发下载

// 后台Service Worker中发消息给当前激活标签页
async function triggerSaveAsDownload(url, saveAs = true) {
  const [tab] = await chrome.tabs.query({active: true, currentWindow: true});
  chrome.tabs.sendMessage(tab.id, {
    action: 'startDownload',
    url: url,
    saveAs: saveAs
  });
}

// content script中接收消息并调用下载接口
chrome.runtime.onMessage.addListener((msg) => {
  if (msg.action === 'startDownload') {
    chrome.downloads.download({
      url: msg.url,
      saveAs: msg.saveAs
    }, (itemId) => {
      // 处理下载回调逻辑
    });
  }
});

方案2：关闭全局下载询问，后台仅触发静默下载 #

如果不需要用户自定义保存路径，保持saveAs: false配置，引导用户关闭Chrome设置中「下载前询问每个文件的保存位置」选项，此时Service Worker中发起的静默下载可以正常执行，不会被拦截。

不要在chrome.downloads.download的回调函数内重复注册chrome.downloads.onChanged监听器，否则每次触发下载都会新增一个常驻监听器，导致后续状态回调重复执行，引发内存泄漏。建议将onChanged监听器做全局单次注册，内部通过下载项id匹配对应任务即可。

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