Protractor自动化测试下载CSV文件出现“Download error”问题求助

这种情况我之前做自动化测试时碰到过好几次，手动操作正常但自动化跑就出问题，核心原因基本都是Protractor启动Chrome时没配置好下载相关的浏览器参数，导致自动化环境下浏览器没法正常完成文件下载流程。下面是几个亲测有效的解决步骤：

• 配置ChromeDriver的下载权限与路径
  在你的protractor.conf.js配置文件里，给chromeOptions添加下载相关的偏好设置，让浏览器在自动化模式下允许下载、跳过弹窗并指定有效路径：

  exports.config = {
    // 其他基础配置...
    capabilities: {
      browserName: 'chrome',
      chromeOptions: {
        prefs: {
          // 替换成你本地存在且有读写权限的文件夹路径
          'download.default_directory': '/Users/xxx/Downloads/test',
          // 禁止下载前的弹窗提示
          'download.prompt_for_download': false,
          // 不自动打开下载的CSV文件（避免干扰测试）
          'download.extensions_to_open': '',
          // 开启安全浏览，避免浏览器拦截下载
          'safebrowsing.enabled': true
        },
        // 无头模式下必须添加的参数（很多人容易忽略）
        args: ['--no-sandbox', '--disable-dev-shm-usage']
      }
    }
  };
  

  重点提醒：download.default_directory一定要用实际存在的路径，否则浏览器会因为权限问题无法写入文件。

• 等待下载完成再做文件验证
  自动化测试经常会出现“触发下载后立刻检查文件”的情况，这时候文件可能还在下载中，导致读取到不完整的文件（显示Download error）。可以写一个等待文件就绪的辅助函数：

  const fs = require('fs');
  const path = require('path');
  
  async function waitForFileReady(filePath, timeout = 30000) {
    const start = Date.now();
    while (Date.now() - start < timeout) {
      if (fs.existsSync(filePath)) {
        // 额外检查文件大小，确保不是空的不完整文件
        const fileStats = fs.statSync(filePath);
        if (fileStats.size > 0) {
          return true;
        }
      }
      await browser.sleep(500);
    }
    return false;
  }
  
  // 在测试用例中调用：
  it('should download CSV without error', async () => {
    // 触发下载按钮点击操作
    await element(by.css('.download-csv-btn')).click();
    const targetFile = path.join('/Users/xxx/Downloads/test', 'data.csv');
    // 等待文件下载完成并就绪
    const isReady = await waitForFileReady(targetFile);
    expect(isReady).toBe(true);
    // 后续可以读取文件内容做进一步验证
  });
  

• 检查浏览器与ChromeDriver版本兼容性
  Protractor 5.4.2对ChromeDriver的版本有特定兼容范围，如果你的Chrome浏览器和ChromeDriver版本不匹配，也可能导致下载异常。可以核对Protractor 5.4.2的版本说明，确保两者版本适配。

另外还有个小细节：如果下载操作是通过新开窗口触发的，要记得用browser.getAllWindowHandles()切换到对应窗口后再等待下载，避免Protractor焦点丢失影响流程。

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