Linux环境下PDO预处理语句UTF-8插入乱码（???）问题求助

遇到这种跨平台的编码不一致问题，大概率是编码链路的某个环节没对齐，结合你的配置情况，我给你梳理几个关键排查和修复步骤：

1. 先检查数据库字段类型（最容易忽略的核心点） #

MSSQL里，VARCHAR是单字节字符类型，仅支持ASCII和部分扩展字符，像əəƏ这类Unicode字符必须用NVARCHAR类型存储。你先确认subjects表的name字段类型：

• 如果当前是VARCHAR，立刻改成NVARCHAR(n)（比如NVARCHAR(255)），这是正确存储Unicode字符的前提。
• 插入时，也可以给字符串值加N前缀（明确告诉MSSQL这是Unicode字符串），修改你的SQL语句：

  $query = $pdo->prepare("INSERT INTO subjects(name,tenant_id) values(N:name, :tenant_id)");
  

2. 修正FreeTDS的配置参数 #

你当前使用的tds version = 8.0对应MSSQL 2000版本，对UTF-8的支持非常有限，建议换成适配新版本MSSQL的版本：

• 打开freetds.conf（通常路径为/etc/freetds/或/usr/local/etc/freetds/），找到你的服务器配置块，修改为：

  [your_mssql_server]
  host = 你的数据库IP
  port = 1433
  tds version = 7.2  # 适配MSSQL 2012及以上版本，对UTF-8支持更完善
  client charset = UTF-8
  

• 用tsql -C命令验证FreeTDS的编译配置，确保输出中包含client charset: UTF-8。

3. 调整PHP PDO的连接配置 #

PHP的PDO连接时，需要明确指定字符集，避免编码自动转换出错：

• 在DSN里加上charset=UTF-8：

  $dsn = "dblib:host=你的数据库IP;dbname=你的数据库名;charset=UTF-8";
  $pdo = new PDO($dsn, 你的用户名, 你的密码);
  

• 同时确保PHP内部编码为UTF-8，在脚本开头添加：

  mb_internal_encoding('UTF-8');
  

4. 用tsql工具验证FreeTDS本身的编码支持 #

先跳过PHP，直接用FreeTDS自带的tsql命令连接数据库，手动执行插入和查询，确认FreeTDS本身能正确处理字符：

# 连接数据库
tsql -S your_mssql_server -U 用户名 -P 密码
# 执行插入和查询操作
USE 你的数据库名;
INSERT INTO subjects(name, tenant_id) VALUES(N'əəƏ', 1);
SELECT * FROM subjects WHERE tenant_id=1;

如果这里查询结果显示正常，说明问题出在PHP的PDO配置；如果还是显示???，那就要重新检查FreeTDS的编译配置（比如是否在编译时启用了UTF-8支持）。

按照这个顺序排查，基本能解决问题——我之前遇到过类似情况，就是字段类型用了VARCHAR加上tds版本太旧导致的。

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