如何用Mocha-Enzyme-Nock测试Axios ArrayBuffer请求及Jenkins失败排查

一、正确测试响应类型为arraybuffer的axios.get请求的方法 #

先梳理下你现有测试里的几个小问题，再给出更可靠的测试写法：

1. 修正测试数据的创建逻辑 #

你原来创建fileContent的写法有语法错误：new Uint8Array(new ArrayBuffer( [72, 101, 108, 108, 111,0])) 是错误的——ArrayBuffer的参数是字节长度，不能直接传数组。正确的方式是直接用数组初始化Uint8Array：

const fileContent = new Uint8Array([72, 101, 108, 108, 111, 0]); // 对应二进制数据"Hello\0"

2. 移除不可靠的setTimeout #

你测试里用setTimeout延迟断言的写法非常不稳定，本地可能因为执行快碰巧通过，但CI环境的时序差异很容易导致断言失效。应该直接在异步回调里执行断言，或者用async/await让逻辑更清晰。

3. 调整Buffer的转换逻辑 #

注意：当axios响应类型是arraybuffer时，response.data是原始二进制数据（ArrayBuffer或Uint8Array），不需要用base64编码转换，直接用Buffer.from(response.data)即可。

改进后的完整测试代码 #

it('should GET file content as array buffer and return correct fileData object', async () => { 
  // 正确构造测试用二进制数据
  const rawFileContent = new Uint8Array([72, 101, 108, 108, 111, 0]);
  const expectedHeaders = {
    "content-type": "application/vnd.ms-excel",
    "content-disposition": 'form-data; name="file"; filename="report_2019-07-30_2019-08-27.xls"'
  };
  const expectedFileData = {
    fileContent: Buffer.from(rawFileContent), // 直接从Uint8Array生成Buffer
    fileHeaders: expectedHeaders
  };

  // 用nock拦截目标请求
  const scope = nock('http://localhost')
    .defaultReplyHeaders(expectedHeaders)
    .get('/filedownloadurl/fileId')
    .reply(200, rawFileContent); // 文件下载一般用200状态码，201是创建成功，不符合场景

  // 用async/await替代done，让异步逻辑更直观可控
  const response = await getBinary('http://localhost/filedownloadurl/fileId');
  
  // 分步骤断言，便于定位问题
  expect(response.fileHeaders).to.deep.equal(expectedFileData.fileHeaders);
  // Buffer实例不能直接用toEqual比较，改用equals方法校验内容一致性
  expect(response.fileContent.equals(expectedFileData.fileContent)).to.be.true;
  
  // 验证nock的拦截确实被触发，避免请求漏拦截的情况
  scope.done();
});

二、本地测试通过但Jenkins失败的原因分析 #

1. Node.js版本差异 #

本地和Jenkins的Node版本可能不一致，Buffer对二进制数据的处理逻辑在不同版本里有细微差异（比如旧版本对Uint8Array转Buffer的兼容性）。建议在项目里添加.nvmrc文件指定Node版本，确保CI和本地环境一致。

2. 异步测试的时序问题 #

你原来用setTimeout+done的写法完全依赖事件循环的执行顺序，本地可能因为资源充足执行快，碰巧让断言在响应处理完成后执行；但Jenkins的CI环境资源有限，执行速度波动大，很容易导致断言执行时响应还未处理完成，或者done()被提前调用。改用async/await可以彻底解决这个时序问题。

3. Nock的拦截匹配问题 #

Jenkins环境可能存在代理、域名解析等配置，导致请求实际发送的URL和nock拦截的URL不匹配（比如是否带 trailing slash、域名是否被代理改写）。可以在测试开头添加nock.debug(true)查看拦截日志，确认nock是否成功命中请求。

4. 断言的严格相等问题 #

toEqual对Buffer对象的比较是基于实例引用的，即使两个Buffer内容完全相同，只要是不同实例就会断言失败。改用Buffer.equals()方法校验内容一致性，才是正确的二进制数据断言方式。

5. CI环境的代理干扰 #

如果Jenkins服务器配置了网络代理，axios请求可能会被转发到代理服务器，导致nock无法拦截本地请求。可以在axios请求配置里显式禁用代理：

axios.get(url, { responseType: 'arraybuffer', proxy: false })

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