使用Chrome扩展下载CSV文件时出现‘检查网络连接’错误的解决求助

排查方向及修复方案 #

1. 补全扩展权限配置 #

Chrome的downloads API必须在manifest.json里声明权限，要是目标CSV在外部站点，还得加对应域名的主机权限：

• 打开manifest.json，确认包含以下配置：

  {
    "permissions": [
      "downloads",
      "https://your-target-domain.com/*"  // 替换成实际的CSV文件域名，或者用"<all_urls>"临时测试
    ]
  }
  

  提示：<all_urls>权限太宽泛，正式发布建议用具体域名。

2. 验证目标URL有效性 #

直接把extensionFileURL复制到浏览器地址栏打开，看能不能正常下载CSV：

• 如果URL打不开、返回404/500错误，Chrome会把这类服务端错误伪装成“网络连接”提示，先把URL的问题解决。
• 要是URL是扩展内部资源（比如chrome-extension://...开头），得确保文件路径正确，Manifest V3还要在web_accessible_resources里配置允许访问。

3. 别依赖navigator.onLine判断 #

navigator.onLine只能检测设备连没连网，管不了目标站点能不能访问——比如你连了Wi-Fi但Wi-Fi没网，或者目标站被拦截，都会触发错误。直接删掉这个判断，看真实错误信息：
修改后的代码：

chrome.downloads.download(
  {
    url: extensionFileURL,
    filename: `${downloadFolderPath}/${ReportName}`,
    saveAs: false,
    conflictAction: "uniquify",
  },
  function (downloadId) {
    if (chrome.runtime.lastError) {
      console.error("Download Error:", chrome.runtime.lastError);
      reject(chrome.runtime.lastError);
    } else {
      console.log(`File downloaded with ID: ${downloadId}`);
      console.log(`Downloaded file path: ${downloadFolderPath}/${ReportName}`);
      resolve(`${downloadFolderPath}/${ReportName}`);
    }
  }
);

另外注意：原代码里console.log用了单引号，模板字符串得用反引号，不然变量不会被解析，已经帮你修正了。

4. 检查下载路径是否合法 #

Chrome对filename参数的路径有要求：

• 只能是默认下载目录的子路径，比如reports/${ReportName}，或者直接写文件名${ReportName}；
• 绝对路径可能受系统权限限制，容易触发错误，建议用相对路径或纯文件名。

5. 排除环境干扰 #

• 要是用的Manifest V3扩展，确保在Service Worker里调用API的上下文正确，别跨上下文操作；
• 试试在Chrome隐身模式下测试，排除其他扩展或浏览器设置（比如安全策略、下载限制）的干扰。

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