Chrome扩展中chrome.downloads.download在后台Service Worker无法触发下载如何解决

核心问题1：DataURL未编码 #

直接拼接纯文本到data:text/plain,前缀会导致特殊字符（换行、空格、符号、非ASCII字符）破坏URL格式，下载请求直接被浏览器拦截。

核心问题2：缺少错误捕获 #

chrome.downloads.download是异步API，调用失败时会返回错误信息，你当前没有加错误回调，无法感知具体失败原因。

可选检查项：manifest.json未声明版本 #

Chrome扩展Manifest V3是当前官方要求的主流版本，你贴的配置里没有写"manifest_version": 3，会导致权限和service worker逻辑不生效。

修复代码 #

1. 修正manifest.json

{
  "manifest_version": 3,
  "name": "页面分析导出工具",
  "version": "1.0",
  "permissions": [
    "activeTab",
    "downloads",
    "scripting"
  ],
  "background": {
    "service_worker": "background.js"
  },
  "action": {}
}

2. 修正background.js下载逻辑

chrome.action.onClicked.addListener((tab) => {
  chrome.scripting.executeScript({
    target: {tabId: tab.id},
    files: ['analysis.js']
  });
});

chrome.runtime.onMessage.addListener((arg, sender, reply) => {
  // 对文本内容做URL编码，兼容所有字符
  const contentUrl = 'data:text/plain;charset=utf-8,' + encodeURIComponent(arg.text);
  chrome.downloads.download({
    url: contentUrl,
    filename: arg.name,
    saveAs: true
  }, (downloadId) => {
    // 打印错误信息便于排查
    if (chrome.runtime.lastError) {
      console.error("下载失败：", chrome.runtime.lastError.message);
    }
  });
  return true;
});

3. analysis.js逻辑无需修改，正常返回分析结果即可。

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