ThinkPHP8数据库连接字符集乱码？_ThinkPHP8设置UTF8连接字符集【修复】-ThinkPHP-PHP中文网

thinkphp 8 数据库连接必须在 dsn 中显式声明 charset=utf8mb4，仅配置 'charset'=>'utf8mb4' 无效；需同步确保 mysql 服务端、表结构、字段、连接层、运行时环境五层全部对齐 utf8mb4，缺一不可。

thinkphp8数据库连接字符集乱码？_thinkphp8设置utf8连接字符集【修复】

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

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'，可能引发冲突或重复执行

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

宝塔面板 PHP 网站管理：站点创建、删除、启停、PHP 版本切换、域名管理、SSL证书管理、伪静态管理、数据库管理

下载

先查真实字段编码：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'); });

光看配置不顶用。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");