必须在dsn中写死charset=utf8mb4，database.php中的'charset'配置无效；需同步配置mysql服务端character-set-server=utf8mb4、重启服务，并升级已有库表字符集与校对规则。
![thinkphp数据库配置中的字符集冲突：解决sqlstate[hy000] general error乱码问题的根本方法](https://img.php.cn/upload/article/001/503/042/178079458988469.jpeg?x-oss-process=image/resize,p_40)
charset=utf8mb4 必须写死在 DSN 里，database.php 中的 'charset' 配置会失效
ThinkPHP5/6 的 'charset' => 'utf8' 或 'charset' => 'utf8mb4' 配置项只在 PDO 构造时尝试注入 DSN，但一旦 DSN 字符串里已有 charset= 子句（比如你手动写了 dsn），这个配置就完全被忽略。更糟的是，某些旧版 mysqlnd 驱动压根不认这个参数。
实操建议：
- 删掉
database.php中所有形如'charset' => 'utf8'的行，避免干扰 - 直接在
'dsn'字段中写死：例如'dsn' => 'mysql:host=127.0.0.1;dbname=test;charset=utf8mb4' - 别用
utf8—— MySQL 的utf8是伪标准，最多存 3 字节，emoji 和生僻字会变成??? - 验证是否生效：连接后执行
Db::query('SELECT @@character_set_client, @@character_set_connection, @@character_set_results')，三个值必须全是utf8mb4
PDO 缓冲查询未启用导致 SQLSTATE[HY000]: General error: 2014
这个错误本质是 MySQL 原生“未缓冲查询”（unbuffered query）机制冲突：当你在一个未取完结果集的查询上再发新查询（比如循环中嵌套查表），PDO 默认不缓存结果，服务端还拿着前一个结果集的游标，就会报错。
实操建议：
- 在
database.php的'params'中添加：PDO::MYSQL_ATTR_USE_BUFFERED_QUERY => true - 不要写成字符串键名，比如
'MYSQL_ATTR_USE_BUFFERED_QUERY'—— 这是常见拼写错误，必须用常量全名 - 如果用了
PDO::ATTR_EMULATE_PREPARES => true，它也能间接缓解该问题，但不如直接开缓冲稳定 - 注意：
fetchAll()只是临时补救，不能替代连接层配置
SQLSTATE[HY000]: General error: 1366 错误说明服务端没配 utf8mb4
Incorrect string value: '\xF0\x9F\x90\xA3' 这类报错不是 PHP 层能绕过去的。哪怕 DSN 写对了 charset=utf8mb4，只要 MySQL 服务端的 character_set_server 还是 latin1 或 utf8，新建表/字段默认就不会用 utf8mb4，插入四字节字符必然失败。
实操建议：
- 检查服务端配置：
SHOW VARIABLES LIKE 'character\_set\_server';，必须是utf8mb4 - 修改
/etc/my.cnf（Linux）或my.ini（Windows），在[mysqld]下加：character-set-server = utf8mb4和collation-server = utf8mb4_unicode_ci - 已有表和字段必须单独升级：
ALTER TABLE table_name CONVERT TO CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci; - 重启 MySQL 服务，否则配置不生效
SQLSTATE[HY000]: General error: 1267 是库/表/列 collation 混用的硬伤
这个错误出现在 JOIN、WHERE 或 ORDER BY 场景下，典型提示是 Illegal mix of collations (utf8_general_ci,IMPLICIT) and (gb2312_chinese_ci,COERCIBLE) —— 说明参与比较的字段来自不同字符序（collation），MySQL 拒绝隐式转换。
实操建议：
- 先查清混用点：
SHOW CREATE TABLE table_name;看每个字段的COLLATE；再查库级：SELECT DEFAULT_COLLATION_NAME FROM information_schema.SCHEMATA WHERE SCHEMA_NAME='your_db'; - 统一 collation 是唯一解法，不能靠 SQL 里加
COLLATE utf8mb4_unicode_ci临时绕过 - 升级整个库：
ALTER DATABASE your_db CHARACTER SET = utf8mb4 COLLATE = utf8mb4_unicode_ci; - 字段级强制统一：
ALTER TABLE t MODIFY COLUMN c VARCHAR(255) CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
真正容易被忽略的，是 MySQL 服务端配置和表结构升级这两步——很多人只改了 PHP 层 DSN 就以为万事大吉，结果线上一插 emoji 就崩。服务端没配对，PHP 层设得再细也没用。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
