thinkphp批量插入中文乱码或截断的根源是utf-8编码链路未对齐：需统一php内部编码（mb_internal_encoding）、数据库连接与字段设为utf8mb4、清理字段缓存、确保数据索引连续且文件无bom。

ThinkPHP批量插入中文乱码或截断，核心不是SQL写错了，而是编码链路在多个环节没对齐——从PHP内部处理、数据库连接、字段缓存到字符串函数调用，任一环节掉链子都会导致中文被截半、变问号或报错。

确保PHP内部统一UTF-8编码

ThinkPHP 5.1+ 默认不强制 mbstring 内部编码，若项目混用 substr、strlen 等原生函数，中文极易被按字节截断：

• 入口文件（如 public/index.php）最开头加：mb_internal_encoding('UTF-8');
• 注释或删除 php.ini 中的 mbstring.func_overload（PHP 8+ 已废弃，保留会干扰）
• 全局搜索项目中所有 substr(、strlen(、strpos(，替换为 mb_substr($str, 0, 10, 'UTF-8') 等带编码参数的版本

数据库连接与字段必须支持 utf8mb4

只设数据库为 utf8 不够，MySQL 的 utf8 实际是 utf8mb3，不支持 emoji 和部分生僻汉字。批量插入时若字段实际是 utf8mb3，中文可能被静默截断或转成 ?：

btpanel phpsite 宝塔面板PHP网站

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

下载

• 建库/改库语句用：CREATE DATABASE xxx CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
• 数据表和字段也显式指定：ALTER TABLE user CONVERT TO CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
• TP 配置中 DSN 加上 ;charset=utf8mb4，例如：mysql:host=127.0.0.1;dbname=test;charset=utf8mb4
• 避免用 SET NAMES utf8，它等价于 utf8mb3；必须用 SET NAMES utf8mb4

批量数据本身要“干净”且索引连续

中文字段值本身没问题，但数组结构出错也会引发异常或丢数据：

• 插入前重置键名：$data = array_values($data); —— 否则 TP5/6 的 insertAll() 可能因非数字索引直接返回 false 或报 Array to string conversion
• 确认字段名完全匹配数据库列名（如 user_name 不能写成 userName），否则非法字段被静默丢弃，中文字段也可能跟着失效
• 新增数据库字段后，务必清空 runtime/Data/_fields/ 下缓存，或临时关闭字段缓存：'DB_FIELDS_CACHE' => false

输出与前端也要同步 UTF-8

即使后端全对了，浏览器解析错也会显示乱码：

• 入口文件加响应头：header('Content-Type: text/html; charset=utf-8');
• HTML 模板 里加：<meta charset="UTF-8">
• 确保 PHP 文件本身保存为 UTF-8 无 BOM（VS Code / PhpStorm 右下角检查，选 “Save with Encoding → UTF-8”）

php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！