Express body-parser在Jest测试中出现UTF-8错误排查求助

这种坑我之前踩过好几次！明明Postman请求一切正常，一跑Jest测试就报UTF-8相关的解析错误，核心问题基本都出在测试环境的请求配置和生产环境不一致上，给你几个针对性的解决方案：

• 强制指定请求头的编码格式
  很多时候Jest测试里用supertest这类工具发送请求时，默认的Content-Type可能没带上charset=utf-8，导致body-parser无法正确识别请求体编码。你可以在测试代码里显式设置：

  await request(app)
    .post('/your-api-path')
    .set('Content-Type', 'application/json; charset=utf-8') // 关键是这行
    .send({ data: '测试内容' });
  

• 检查body-parser的全局配置
  确认你的Express应用里body-parser的配置是否明确指定了编码，避免测试环境下默认配置走样：

  const bodyParser = require('body-parser');
  // 全局设置UTF-8编码
  app.use(bodyParser.json({ charset: 'utf-8' }));
  app.use(bodyParser.urlencoded({ extended: true, charset: 'utf-8' }));
  

• 排查请求体的序列化问题
  如果你的测试里是手动序列化请求体（比如用JSON.stringify()），要确保序列化后的字符串是UTF-8编码的。另外，尽量让测试工具自动处理序列化（比如supertest的.send()方法直接传对象），减少手动编码出错的可能。

• 调整Jest的环境编码设置
  极少数情况下，Jest的运行环境默认编码不是UTF-8，你可以在jest.config.js里添加环境变量配置：

  module.exports = {
    // ...其他配置
    testEnvironmentOptions: {
      env: {
        LANG: 'en_US.UTF-8',
        LC_ALL: 'en_US.UTF-8'
      }
    }
  };
  

先从第一个方案试起，大多数情况下加了指定编码的请求头就能解决问题！

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