query-string模块stringify方法在Jest测试中表现不符合预期

看起来你遇到的问题核心是query-string默认不会自动提取对象数组里的id属性，同时可能存在测试环境和生产环境的调用逻辑或依赖版本不一致的情况。

问题分析 #

当你直接把[{ id: '123' },{ id: '321' }]这类对象数组传给queryString.stringify()，或者传递{ id: 该数组 }时，query-string会把每个对象直接转为字符串表示（也就是[object Object]），这就是Jest里输出异常的原因。而生产环境能得到正确结果，大概率是实际运行的代码里做了数组映射（比如提前提取了id值），或者依赖版本不同导致行为差异。

解决方案 #

1. 修正原代码的调用方式（推荐）

先将对象数组映射为纯id值的数组，再结合arrayFormat参数指定重复key的格式：

// 原代码修改为：
const idList = ids.map(item => item.id);
const result = queryString.stringify({ id: idList }, { arrayFormat: 'repeat' });

这样无论在浏览器还是Jest测试中，都会输出id=123&id=321，彻底保证环境行为一致。

2. 确保依赖版本一致

检查你的package.json中query-string的版本，执行npm ls query-string确认Jest环境和生产环境使用的是同一个版本。不同版本的query-string对数组的默认处理逻辑可能不同，比如旧版本默认arrayFormat为'repeat'，新版本可能默认是'comma'。

3. 模拟query-string的行为（临时适配方案）

如果暂时无法修改原代码，可以在Jest测试中mockquery-string的stringify方法，让它适配你的数据结构：

jest.mock('query-string', () => {
  const originalModule = jest.requireActual('query-string');
  return {
    ...originalModule,
    stringify: jest.fn((data, options) => {
      // 针对你的特定数据结构做处理
      if (Array.isArray(data) && data.every(item => 'id' in item)) {
        return data.map(item => `id=${item.id}`).join('&');
      }
      // 其他情况沿用原方法逻辑
      return originalModule.stringify(data, options);
    })
  };
});

总结 #

最稳妥的方式是修正原代码的调用逻辑，确保传递给query-string的是正确的纯值数组而非对象数组，同时保持依赖版本一致，这样测试和生产环境的行为就能完全对齐了。

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