NodeJS API部署VPS后重音字符编码异常问题求助

一、数据库连接编码配置错误 #

你当前设置的charset: 'utf8mb4_unicode_ci'是错误的——utf8mb4_unicode_ci是排序规则（collation），而非字符集编码。正确的字符集参数值应为utf8mb4，排序规则可由数据库自动匹配对应规则，或单独指定。

修正后的连接代码：

const connection = mysql.createConnection({
  host: process.env.HOST,
  port: process.env.PORT,
  user: process.env.DB_USER,
  password: process.env.PASSWORD,
  database: process.env.DB,
  charset: 'utf8mb4'
});

连接建立后，也可手动执行SQL强制指定编码规则：

SET NAMES 'utf8mb4' COLLATE 'utf8mb4_unicode_ci';

二、数据库/表/字段的编码一致性检查 #

即使连接配置正确，数据库层面的编码不匹配也会导致乱码：

• 检查数据库默认编码：执行SHOW CREATE DATABASE your_db_name;，确认输出包含CHARACTER SET utf8mb4和COLLATE utf8mb4_unicode_ci。
• 检查表编码：执行SHOW CREATE TABLE your_table_name;，确保表的字符集和排序规则为utf8mb4系列。
• 检查字段编码：针对存储字符串的字段（如VARCHAR、TEXT），确认其CHARACTER SET为utf8mb4。

若存在编码不匹配，可执行以下SQL修改：

ALTER DATABASE your_db_name CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
ALTER TABLE your_table_name CONVERT TO CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;

三、OVH VPS系统环境编码问题 #

这很可能是“几天后才出现乱码”的核心原因：

1. 系统locale配置：执行locale命令，检查输出是否包含UTF-8相关设置（如LANG=en_US.UTF-8）。若没有，需修改系统locale：

   sudo locale-gen en_US.UTF-8
   sudo update-locale LANG=en_US.UTF-8
   

   修改后重启NodeJS服务生效。
2. NodeJS进程编码强制：可在启动服务时直接指定编码环境变量，避免依赖系统默认配置：

   LC_ALL=en_US.UTF-8 node your_api_entry.js
   

3. OVH系统自动更新影响：部分OVH VPS在自动系统更新后，locale配置可能被重置为非UTF-8值，导致编码环境突变。

四、API响应编码设置 #

确保NodeJS API的响应头明确指定UTF-8编码：

res.setHeader('Content-Type', 'application/json; charset=utf-8');

若使用Express框架，可全局配置：

app.use((req, res, next) => {
  res.setHeader('Content-Type', 'application/json; charset=utf-8');
  next();
});

五、数据写入环节验证 #

• 确认客户端（如Postman）发送的数据为UTF-8编码（Postman默认是UTF-8，但需排查第三方客户端的异常情况）。
• NodeJS字符串默认是UTF-16编码，只要数据库连接配置正确，驱动会自动转成utf8mb4写入，无需额外处理。

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