ThinkPHP8数据库连接字符集乱码？_ThinkPHP8设置UTF8连接字符集【修复】

先说一个在很多项目里反复出现的问题：ThinkPHP 8 连上数据库后，中文、emoji 或者生僻字全都变成了 ????，甚至直接被截断。你查了表结构，字段确实是 utf8mb4，库也是 utf8mb4，但问题依旧。问题出在哪儿？答案很直接——DSN 里没写 charset=utf8mb4。这不是配置“没生效”，而是从一开始就没走对路。

ThinkPHP 8 的数据库连接默认并不强制使用 utf8mb4。哪怕你把表、库、字段全设成 utf8mb4，只要 DSN 没声明或 PDO 连接没生效，中文、emoji、生僻字照样变 ???? 或静默截断——这不是配置“没生效”，而是根本没走对路。

DSN 中必须显式写 charset=utf8mb4，不能靠 params 补救

TP8 的数据库配置文件（config/database.php）里，那个 'charset' => 'utf8mb4' 其实更多是个“备胎”——它只影响部分驱动的 fallback 行为，并不保证 PDO 初始化时真的会帮你执行 SET NAMES。真正起作用的，是 DSN 字符串本身。

• ✅ 正确写法：'dsn' => 'mysql:host=127.0.0.1;dbname=think8;charset=utf8mb4;'
• ❌ 错误写法：'charset' => 'utf8mb4' 单独配，但 DSN 里没 charset=——在某些 PDO 版本和 MySQL 服务端组合下会直接失效
• ⚠️ 别用 utf8：MySQL 的 utf8 只是三字节的伪 UTF-8，根本装不下 emoji 和大部分扩展汉字；utf8mb4 才是完整实现
• 如果 DSN 已经带了 charset，就别在 params 里再重复加 PDO::MYSQL_ATTR_INIT_COMMAND => 'SET NAMES utf8mb4'，否则可能引发冲突或重复执行，反而更乱

SHOW CREATE TABLE 显示字段没带 CHARACTER SET utf8mb4？这不是 TP8 的锅

TP8 的迁移（Schema::table()）或模型创建时，并不会自动给每个字段补上字符集声明，它只会按当前表默认的字符集来继承。也就是说，哪怕你 DSN 连上了 utf8mb4，但如果老表是 utf8 或 latin1，新增字段照样是错的。

• 先查真实字段编码：SHOW CREATE TABLE user;——重点看字段定义末尾有没有 CHARACTER SET utf8mb4
• 批量修复整表（推荐做法）：ALTER TABLE `user` CONVERT TO CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
• 单字段补救（TP8 可用原生语句）：DB::statement("ALTER TABLE `user` MODIFY `name` VARCHAR(50) CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci");
• 新建表时务必指定：Schema::create('posts', function (Blueprint $table) { $table->string('title')->charset('utf8mb4')->collation('utf8mb4_unicode_ci'); });

连接后立刻验证 character_set_client 是否真为 utf8mb4

光看配置文件是没用的。MySQL 连接建立后，客户端实际使用的字符集可能被环境变量、my.cnf 或者中间件给覆盖掉。必须运行时确认。

• 在任意控制器或命令行中加一句：dump(DB::select("SELECT @@character_set_client, @@character_set_connection, @@character_set_results")[0]);
• 三个值必须都是 utf8mb4；如果出现 utf8 或 gbk，说明 DSN 没生效，或者 MySQL 服务端配置还没重启生效
• Windows 下尤其要注意：MySQL 安装器经常默认把 character-set-server 设成 gbk，你得手动改 my.ini 并重启 mysqld
• TP8 不支持全局连接回调钩子，如果需要强制重设，可以在 app/Providers/AppServiceProvider.php 的 boot() 中调用：DB::connection()->getPdo()->exec("SET NAMES utf8mb4 COLLATE utf8mb4_unicode_ci");

最容易被忽略的一个动作是：改完 DSN 和 my.cnf 后，忘记重启 PHP-FPM 或 Apache，导致缓存中的旧连接还在跑。另外，开发时用 CLI 命令跑迁移，却忘了 CLI 环境下的 php.ini 和 Web 环境不是同一份——这两处一漏，前面所有配置都白费了。