注册表单出现SQLSTATE[HY000] 3988编码排序规则转换错误求助

开发注册表单时，首次注册会抛出如下错误：

Uncaught PDOException: SQLSTATE[HY000]: General error: 3988 Conversion from collation utf8mb3_general_ci into utf8mb4_general_ci impossible for parameter

后续注册可正常执行，添加status字段后出现该问题，错误非持续性，有时抛出致命错误后代码仍会继续执行。

相关代码 #

建表SQL #

CREATE TABLE `users` (
    `id` varchar(30) NOT NULL,
    `username` varchar(50) NOT NULL,
    `password` varchar(255) NOT NULL,
    `status` varchar(50) NOT NULL,
    PRIMARY KEY (`id`),
    UNIQUE KEY `username` (`username`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_general_ci

数据库连接代码 #

<?php

$db_config = $config['db_engine'] . ":host=".$config['db_host'] . ";dbname=" . $config['db_name'].";charset=utf8mb4";

try {
    $pdo = new PDO($db_config, $config['db_user'], $config['db_password'], [
        PDO::MYSQL_ATTR_INIT_COMMAND => "SET NAMES utf8"
    ]);

    $pdo->setAttribute(PDO::ATTR_ERRMODE, PDO::ERRMODE_EXCEPTION);
    $pdo->setAttribute(PDO::ATTR_EMULATE_PREPARES, false);
} catch (PDOException $e) {
    exit("Impossibile connettersi al database: " . $e->getMessage());
}
?>

注册插入代码 #

$query = "
                INSERT INTO users
                VALUES (:id, :username, :password, :status)
            ";
$status = "Active now";
$check = $pdo->prepare($query);
$check->bindParam(':id', $randomID, PDO::PARAM_STR);
$check->bindParam(':username', $username, PDO::PARAM_STR);
$check->bindParam(':password', $password_hash, PDO::PARAM_STR);
$check->bindParam(':status', $status, PDO::PARAM_STR);
$check->execute();

if ($check->rowCount() > 0) {
    $msg = 'Registrazione eseguita con successo';
} else {
    $msg = 'Problemi con l\'inserimento dei dati';
}

错误原因 #

连接字符串中已指定charset=utf8mb4，但同时在PDO初始化参数中设置了PDO::MYSQL_ATTR_INIT_COMMAND => "SET NAMES utf8"——MySQL中的utf8实际对应utf8mb3字符集，与表使用的utf8mb4字符集冲突，导致参数在collation转换时失败。首次连接时初始化命令的执行时机触发了该错误，后续连接复用或状态变化后冲突暂时消失，造成错误非持续性。

解决步骤 #

修改数据库连接代码，移除PDO::MYSQL_ATTR_INIT_COMMAND => "SET NAMES utf8"这一初始化参数，仅保留连接字符串中的charset=utf8mb4即可确保连接字符集与表字符集一致。修改后的连接代码如下：

<?php

$db_config = $config['db_engine'] . ":host=".$config['db_host'] . ";dbname=" . $config['db_name'].";charset=utf8mb4";

try {
    $pdo = new PDO($db_config, $config['db_user'], $config['db_password']);

    $pdo->setAttribute(PDO::ATTR_ERRMODE, PDO::ERRMODE_EXCEPTION);
    $pdo->setAttribute(PDO::ATTR_EMULATE_PREPARES, false);
} catch (PDOException $e) {
    exit("Impossibile connettersi al database: " . $e->getMessage());
}
?>

额外说明 #

• SET NAMES utf8会将连接字符集设为utf8mb3，而utf8mb4是完整的UTF-8实现，支持emoji等4字节字符，两者的collation不兼容会引发转换错误。
• 连接字符串中的charset=utf8mb4已足够设置正确的连接字符集，无需额外通过初始化命令重复设置。

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