Windows Server下NodeJS+Prisma写入MSSQL出现字符乱码（�）问题

问题场景 #

在Windows Server 2019环境下，使用NodeJS脚本结合Prisma库向MSSQL数据库写入数据，目标字段为NVARCHAR(1000)类型（理论支持特殊字符）。通过fs.readFileSync(customJobPath, 'utf8')读取包含单词Gardé的txt文件，本地数据库可正常保存该单词，但生产环境MSSQL数据库中显示为Gard�。

已完成的排查操作 #

• 执行SELECT DATABASEPROPERTYEX(DB_NAME(), 'Collation') AS DatabaseCollation;查询，本地与生产环境数据库排序规则均为SQL_Latin1_General_CP1_CI_AS
• 在Tableplus中手动插入é字符，可正常保存

可能遗漏的配置/排查方向 #

1. Prisma连接字符串的字符集参数 #

检查生产环境的Prisma连接字符串，是否明确指定UTF-8编码相关参数。例如在连接字符串中添加CharacterSet=UTF-8，确保驱动与数据库通信时使用正确编码：

DATABASE_URL="sqlserver://your-server:1433;database=your-db;user=your-user;password=your-pass;CharacterSet=UTF-8;encrypt=true"

2. NodeJS进程的环境编码设置 #

Windows Server系统默认编码可能非UTF-8，导致数据传输时编码转换异常。可在NodeJS脚本开头强制指定UTF-8环境变量：

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

或在启动脚本时通过命令行指定：

set LANG=en_US.UTF-8 && node your-script.js

3. Prisma Schema字段映射验证 #

确认Prisma Schema中对应字段是否正确映射为NVARCHAR类型，避免隐式编码转换：

model YourModel {
  id        Int      @id @default(autoincrement())
  targetField String  @db.NVarChar(1000)
}

重新生成Prisma客户端并部署到生产环境，确保映射生效。

4. 目标字段的独立排序规则检查 #

虽然数据库整体排序规则一致，但单个字段的排序规则可能存在差异。执行以下SQL查询目标字段的排序规则：

SELECT COLUMN_NAME, COLLATION_NAME 
FROM INFORMATION_SCHEMA.COLUMNS 
WHERE TABLE_NAME = 'YourTableName' AND COLUMN_NAME = 'TargetColumnName';

若字段排序规则与数据库不一致，执行修改语句对齐：

ALTER TABLE YourTableName
ALTER COLUMN TargetColumnName NVARCHAR(1000) COLLATE SQL_Latin1_General_CP1_CI_AS;

5. 生产环境文件编码验证 #

确认生产环境中txt文件的实际编码是否为UTF-8。可在脚本中添加编码检测逻辑：

const fs = require('fs');
const buffer = fs.readFileSync(customJobPath);
// 通过BOM或字符特征判断编码，若为Latin1则转换为UTF-8
const content = buffer.includes(Buffer.from([0xEF, 0xBB, 0xBF])) 
  ? buffer.toString('utf8') 
  : buffer.toString('latin1').toString('utf8');

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