ThinkPHP项目迁移数据库字段乱码_字符集编码与数据库校对规则处理-ThinkPHP-PHP中文网

必须执行 alter table ... convert to character set utf8mb4 collate utf8mb4_unicode_ci 并确保 web 服务器透传 utf-8 content-type，否则数据库和 php 层配置均无效。

thinkphp项目迁移数据库字段乱码_字符集编码与数据库校对规则处理

MySQL 表字符集不是 `utf8mb4`，`ALTER TABLE` 时容易漏掉校对规则

ThinkPHP 迁移执行 Schema::table() 或原生 SQL 时，如果表本身是 latin1 或 utf8（非 utf8mb4），新增字段默认继承表字符集，但 ThinkPHP 的迁移生成器不会自动补全 COLLATE。结果就是字段能存，但中文、emoji、四字节字符一写就变问号或截断。

实操建议：

btpanel phpsite 宝塔面板PHP网站

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

下载

迁移前先查表默认校对：执行 SHOW CREATE TABLE `users`;，看 DEFAULT CHARSET 和 COLLATE 是什么
在迁移文件中显式指定：用 ->charset('utf8mb4')->collation('utf8mb4_unicode_ci')（TP6+）；TP5.1 需在 DB::statement() 中手写 ALTER TABLE ... ADD COLUMN ... VARCHAR(255) CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci
别依赖 DB_CONFIG 里的 charset，它只影响连接层，不改变建表/改表行为

ThinkPHP 连接配置里 `charset` 设成 `utf8`，实际连的是 `utf8mb4` 表也照样乱码

MySQL 的 utf8 是阉割版（最多三字节），而 PHP PDO 默认按配置值发 SET NAMES。设成 utf8 后，即使表是 utf8mb4，连接层也不允许四字节字符流通，INSERT 会静默截断，SELECT 出来是乱码。

实操建议：

数据库配置必须写死 'charset' => 'utf8mb4'，不能写 'utf8' 或留空
确认 MySQL 服务端已启用 utf8mb4：检查 my.cnf 中 character-set-server = utf8mb4 和 collation-server = utf8mb4_unicode_ci，且重启了 mysqld
连接后立刻执行 DB::statement("SET NAMES utf8mb4 COLLATE utf8mb4_unicode_ci")（TP5.1 可放 Db::connect() 回调里），避免中间件或模型操作抢在连接初始化前触发查询

`php artisan migrate` 成功但字段仍是 `utf8`，因为 TP 的迁移没走 `ENGINE=InnoDB DEFAULT CHARSET=utf8mb4`

ThinkPHP 的迁移命令不重置整张表的字符集，只改字段。如果原表是 ENGINE=MyISAM DEFAULT CHARSET=utf8，哪怕你加了新字段并指定了 utf8mb4，整表默认字符集没变，后续新增字段仍会继承旧的 utf8。

实操建议：

迁移前统一转表：执行 ALTER TABLE `users` CONVERT TO CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
不要只改 DEFAULT CHARSET，必须带 CONVERT TO，否则索引、TEXT 字段可能不生效
TP6 的 Schema::create() 默认不带 ENGINE 和 CHARSET，需手动追加：用 ->engine('InnoDB')->charset('utf8mb4')->collation('utf8mb4_unicode_ci')

前端 POST 数据正常，但 `$request->post()` 拿到的是乱码，其实是 Nginx/Apache 编码转发问题

数据库和 PHP 层都设对了，但请求体里的中文进到 ThinkPHP 就是乱码，大概率是 Web 服务器没把原始 UTF-8 请求头完整透传给 PHP-FPM。特别是用了反向代理或 CDN 后，Content-Type 被覆盖、charset 丢失很常见。

实操建议：

在 Nginx 配置里加：fastcgi_param CONTENT_TYPE $content_type; 和 charset utf-8;（注意是 utf-8，不是 utf8）
Apache 下确认 AddDefaultCharset UTF-8 已启用，且没有 php_flag default_charset 覆盖它
临时验证：在控制器开头打日志 file_put_contents('/tmp/raw', file_get_contents('php://input'));，看原始 body 是否乱码——如果是，问题一定出在 Web 服务器或负载层