thinkphp中文乱码需统一utf8mb4字符集：一、mysql服务端及库表字段设为utf8mb4；二、database.php中charset设为utf8mb4并禁用预处理模拟；三、.env配置db_charset=utf8mb4并动态注入；四、运行时验证连接层三项字符集均为utf8mb4；五、模型声明$charset='utf8mb4'，批量写入指定类型，json字段用utf8mb4。
如果您在ThinkPHP项目中遇到中文存储乱码、查询结果出现问号或方块等异常字符，则很可能是数据库字符集与连接层配置不一致导致的。以下是解决此问题的具体步骤：
一、统一数据库服务端字符集为utf8mb4
确保MySQL服务器、数据库、数据表及字段均使用utf8mb4字符集，这是支持完整Unicode（包括emoji）的基础前提。
1、登录MySQL命令行，执行以下语句查看当前服务器默认字符集：
SHOW VARIABLES LIKE 'character_set%';
2、修改MySQL配置文件my.cnf（Linux）或my.ini（Windows），在[mysqld]段下添加或确认以下配置：
character-set-server = utf8mb4
collation-server = utf8mb4_unicode_ci
3、重启MySQL服务使配置生效。
4、对已存在的数据库执行变更命令：
ALTER DATABASE 数据库名 CHARACTER SET = utf8mb4 COLLATE = utf8mb4_unicode_ci;
5、对已存在的每张数据表执行转换：
ALTER TABLE 表名 CONVERT TO CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
二、配置ThinkPHP数据库连接字符集参数
在database.php配置文件中显式声明charset参数，确保PDO或mysqli连接初始化时即使用utf8mb4编码，避免连接后手动set_charset的延迟风险。
1、打开config/database.php文件，定位到mysql连接配置数组。
2、将'charset'项值明确设置为utf8mb4：
'charset' => 'utf8mb4',
3、若使用PDO连接，还需在'params'中追加PDO属性以禁用预处理模拟：
'params' => [
PDO::ATTR_EMULATE_PREPARES => false,
],
4、保存文件后，清除运行时配置缓存：
php think clear:config
三、通过.env文件动态注入utf8mb4字符集配置
利用ThinkPHP 6+的环境变量机制，将字符集配置从代码中解耦，便于多环境差异化管理，同时保证.env中声明优先于database.php默认值。
1、在项目根目录创建或编辑.env文件，确保其编码为UTF-8无BOM格式。
2、在[DATABASE]节区添加以下内容：
DB_CHARSET=utf8mb4
3、修改config/database.php中mysql连接的charset配置为：
'charset' => env('DB_CHARSET', 'utf8mb4'),
4、确认入口文件public/index.php中已调用think\initializer\Env::init()（新版骨架默认已启用）。
5、执行php think clear:config强制重载配置。
四、验证连接层实际使用的字符集
在应用运行时主动检测PDO或mysqli连接对象是否真实协商了utf8mb4，避免配置被覆盖或未生效。
1、在控制器中临时插入调试代码：
$connection = \think\facade\Db::getConnection();
dump($connection->getPdo()->getAttribute(PDO::ATTR_SERVER_VERSION));
2、执行SQL查询验证当前连接字符集：
Db::query("SELECT @@character_set_client, @@character_set_connection, @@character_set_results");
3、确认返回结果中三项均为utf8mb4。
4、若其中任一项非utf8mb4，检查中间件、全局事件或自定义连接类是否覆盖了charset设置。
五、同步修正模型与查询构造器行为
即使连接层正确，ThinkPHP模型在生成INSERT/UPDATE语句时若未携带字符集上下文，仍可能触发隐式转换失败。需确保模型操作全程维持utf8mb4语义。
1、在模型类顶部添加静态属性声明：
protected $charset = 'utf8mb4';
2、对批量写入场景，显式指定字段绑定类型：
Db::name('user')->insert(['name' => '张三'], ['name' => 'string']);
3、若使用JSON字段，确认MySQL版本≥5.7.8且字段类型为JSON，并在migration中指定：
$table->json('settings')->charset('utf8mb4');
4、在application/common.php中注册全局钩子，拦截所有SQL执行前强制SET NAMES：
\think\facade\Db::listen(function ($sql, $time, $explain) {
if (strpos($sql, 'INSERT') === 0 || strpos($sql, 'UPDATE') === 0) {
Db::execute("SET NAMES utf8mb4");
}
});
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
