ThinkPHP8数据库连接字符集乱码？_ThinkPHP8设置UTF8连接字符集【修复】
ThinkPHP8数据库中文乱码因数据源未显式设置字符集UTF8MB4引起，仅配置字符集参数无效。需在数据源中声明UTF8MB4，并确保表字段字符集一致，用建表语句验证，必要时转换修复。同时检查客户端与服务端字符集，改后重启PHP-FPM进程。
先说一个在很多项目里反复出现的问题：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 环境不是同一份——这两处一漏，前面所有配置都白费了。