NestJS API偶发UTF-8特殊字符乱码（U+FFFD）问题求助

1. 强制NestJS全局启用UTF-8编码 #

在项目主入口main.ts中添加全局中间件，确保所有响应和请求都强制使用UTF-8编码：

app.use((req, res, next) => {
  // 强制响应内容编码为UTF-8
  res.setHeader('Content-Type', 'application/json; charset=utf-8');
  // 确保请求解析时用UTF-8
  req.setEncoding('utf-8');
  next();
});

调用OTHER_SERVICE时，显式在请求头指定编码：

this.httpService.post('OTHER_SERVICE_ENDPOINT', sendResourceDto, {
  headers: {
    'Content-Type': 'application/json; charset=utf-8',
    'Accept': 'application/json; charset=utf-8'
  }
});

2. 检查Nest序列化器的编码逻辑 #

如果使用了ClassSerializerInterceptor或自定义序列化器，排查以下点：

• 禁止手动转换字符串编码（如Buffer.from(str).toString('ascii')这类操作会直接破坏UTF-8字符）；
• 检查全局拦截器是否存在篡改响应内容的逻辑，比如某些压缩中间件可能默认使用非UTF-8编码。

3. 修正Node.js进程的环境编码配置 #

生产环境中Node.js的默认编码可能被系统环境变量覆盖，在启动脚本中强制设置：

export LC_ALL=en_US.UTF-8
export LANG=en_US.UTF-8
node dist/main.js

也可以在代码开头直接设置：

process.env.LC_ALL = 'en_US.UTF-8';
process.env.LANG = 'en_US.UTF-8';

4. 验证OTHER_SERVICE的接收编码设置 #

即使是本地通信，OTHER_SERVICE也可能未正确配置请求解析编码：

• 若对方是Express服务，确保开启UTF-8解析：

app.use(express.json({ charset: 'utf-8' }));

• 若对方也是NestJS服务，同步执行第一步的全局编码配置。

5. 排查周期性进程异常 #

因为问题是周期性出现，需关注进程长期运行后的状态：

• 使用PM2等进程管理器，设置自动重启策略（如每日重启），临时规避进程异常导致的编码错乱；
• 开启Node.js的--trace-events-enabled参数，记录进程编码相关操作日志，问题出现时回溯定位；
• 监控进程内存、CPU状态，排查是否存在内存泄漏引发的进程行为异常。

6. 升级序列化相关依赖 #

检查class-transformer、class-validator等序列化依赖的版本，部分旧版本存在UTF-8处理bug，升级到最新稳定版：

npm install class-transformer@latest class-validator@latest

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