本文详解如何解决 pdo 在使用 utf8mb4 字符集时因连接层仍默认使用 utf8（即 utf8mb3）引发的 collation 转换错误（sqlstate hy000: 3988），重点在于 dsn 中显式声明 charset 并修正初始化命令。
本文详解如何解决 pdo 在使用 utf8mb4 字符集时因连接层仍默认使用 utf8（即 utf8mb3）引发的 collation 转换错误（sqlstate hy000: 3988），重点在于 dsn 中显式声明 charset 并修正初始化命令。
在构建支持 Emoji、中文生僻字及现代 Unicode 字符的 Web 应用（如评论系统）时，将数据库表升级为 utf8mb4 字符集是必要步骤。然而，仅修改表结构（如 CHARSET=utf8mb4 COLLATE=utf8mb4_general_ci）并不足够——客户端连接层也必须同步适配，否则会触发 Conversion from collation utf8mb3_general_ci into utf8mb4_general_ci impossible for parameter 这一典型错误。
根本原因在于：PDO 默认通过 DSN 连接时未指定字符集，即使表使用 utf8mb4，连接仍以旧版 utf8（实际为 utf8mb3）协商；而 PDO::MYSQL_ATTR_INIT_COMMAND => "SET NAMES utf8" 进一步强化了该错误配置，导致服务端与客户端 collation 不匹配，参数绑定失败。
✅ 正确做法是 在 DSN 中直接声明 charset=utf8mb4，并移除或更新初始化命令：
// ✅ 推荐：DSN 中显式指定 charset=utf8mb4
$db_config = $config['db_engine'] . ":host=" . $config['db_host']
. ";dbname=" . $config['db_name']
. ";charset=utf8mb4"; // ← 关键！强制连接使用 utf8mb4
try {
$pdo = new PDO($db_config, $config['db_user'], $config['db_password'], [
// ⚠️ 移除或更新以下行：原 "SET NAMES utf8" 会覆盖 DSN 的 charset
PDO::MYSQL_ATTR_INIT_COMMAND => "SET NAMES utf8mb4", // ← 若保留，必须改为 utf8mb4
PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION,
PDO::ATTR_EMULATE_PREPARES => false,
]);
} catch (PDOException $e) {
exit("Impossibile connettersi al database: " . $e->getMessage());
}
? 补充注意事项：
-
PDO::ATTR_EMULATE_PREPARES => false必须启用，确保使用原生预处理语句，避免字符集在模拟层被错误转换； - 确保 MySQL 服务端已启用
utf8mb4支持（检查my.cnf中collation-server = utf8mb4_unicode_ci和character-set-server = utf8mb4）； - 所有相关字段（如
message TEXT）需确认实际字符集：SHOW FULL COLUMNS FROM comments;； - 浏览器/前端也应声明
<meta charset="UTF-8">，形成端到端 utf8mb4 链路。
完成上述配置后，bindParam() 将能正确传递含 Emoji 或四字节 Unicode 的评论内容，彻底规避 collation 转换异常。
