ThinkPHP中报Data too long的数据库字段长度与数据截断处理

MySQL报“Data too long”是服务端拒绝写入，需核对字段定义与数据字节长度；VARCHAR按字节限制（UTF8MB4下中文占4字节），用strlen而非mb_strlen校验；ThinkPHP不自动截断，需在beforeWrite或SQL层手动处理。

MySQL报 Data too long for column 时，不是PHP或ThinkPHP的问题

遇到这个错误，先别急着去折腾框架配置或者模型验证。本质上，这是MySQL服务端直接拒绝了你的写入请求，ThinkPHP只是把这个错误原封不动地抛给你而已。解决问题的第一步，永远是核对数据本身和数据库字段的定义是否匹配。

典型的错误信息长这样：SQLSTATE[22001]: String data, right truncated: 1406 Data too long for column 'title' at row 1。注意看，它已经明确告诉你是哪个字段、哪一行出了问题。

• 第一步，用 SHOW CREATE TABLE `your_table` 命令，仔细看看目标字段的定义，到底是 VARCHAR(50) 还是 TEXT。
• 第二步，在PHP里用 strlen($data['title']) 检查字节长度。这里有个关键点：务必用 strlen，而不是 mb_strlen。因为MySQL的 VARCHAR 长度限制是按字节计算的，在UTF8MB4编码下，一个中文字符就占了4个字节。
• 最后要明确一点：ThinkPHP默认并不会帮你自动截断超长数据，更不会静悄悄地丢弃部分内容。它会老老实实地把完整数据交给MySQL，然后被数据库层面拦下来报错。

ThinkPHP 6/7 中控制写入前截断的两种方式

如果业务上确实需要自动截断超长内容，而不是直接报错，那就得自己动手添加逻辑。框架本身不提供全局的“自动截断”开关，这其实可以理解——数据是截断还是报错，属于具体的业务决策，不应该做成一个通用的默认行为。

• 方式一：在模型的 beforeWrite 事件里处理。这是最清晰、最符合MVC模式的做法。在数据写入数据库之前，进行长度判断和截断。

  protected function beforeWrite(): void
  {
      if (isset($this->title) && strlen($this->title) > 50) {
          $this->title = substr($this->title, 0, 50);
      }
  }

• 方式二：使用 Db::raw() 配合 SUBSTR 在SQL层截断。这种方法更适合一些批量插入的场景，或者在不方便修改模型逻辑的时候使用。

  Db::name('article')->insert([
      'title' => Db::raw("SUBSTR('超长标题...', 1, 50)"),
  ]);

• 这里有个常见的误区：不要指望用验证器（validate）里的 length:50 规则来解决这个问题。这个规则校验的是字符数（使用 mb_strlen），而MySQL校验的是字节数。一旦内容里包含中文等多字节字符，两者就不等价了，验证器通过了，数据库照样会报错。

字段类型选 VARCHAR 还是 TEXT？关键看查询和索引需求

看到字段可能超长，是不是第一反应就想换成 TEXT？先等等，这个决定可能会带来一些隐性的代价。

立即学习“PHP免费学习笔记（深入）”；

• 索引支持：VARCHAR(255) 这样的字段可以轻松创建前缀索引（例如 INDEX(title(100))）。而 TEXT 字段如果想建索引，必须指定前缀长度，灵活性反而可能下降。
• 性能影响：TEXT 列默认不会参与使用内存临时表（MEMORY 引擎）的操作。这意味着，一旦查询中涉及到对这个字段的 GROUP BY 或 ORDER BY，临时表就可能会被迫写入磁盘，导致查询速度明显变慢。
• 所以，到底怎么选？如果这个字段确实经常超过255字节，并且几乎不需要用来做查询条件、排序或建立索引（比如文章详情、操作日志），那么用 TEXT 更省心。反之，如果这个字段需要被频繁搜索、排序或关联查询，那么从性能出发，更应该坚持使用 VARCHAR，并通过业务规则来严格控制其长度。

调试时容易漏掉的编码陷阱

明明感觉长度算对了，为什么还是报错？问题可能出在编码环节。同一段中文字符串，在不同的处理阶段，其编码方式可能悄悄发生变化，导致长度计算和最终入库的结果对不上。

• PHP文件编码：确保你的PHP源文件保存为 UTF-8 without BOM 格式。如果带了BOM头，strlen 计算出的字节数会多出几个，但这几个字节在入库时可能不被计入，从而引发误判。
• 数据库连接字符集：必须在ThinkPHP的数据库配置中显式设置 'charset' => 'utf8mb4'。否则，即使表字段是 utf8mb4，连接层也可能默认使用 utf8（即最多3字节的UTF-8），导致四字节的字符（如一些emoji）无法正确存储或长度计算出错。
• 数据来源编码：对于前端通过POST传递的参数，无论是表单还是JSON，经过 $_POST 或框架的 input() 方法解析后，通常已经是UTF-8字符串了。直接使用 strlen 计算即可，不要再画蛇添足地进行 mb_convert_encoding 转换，否则反而可能引入错误。

说到底，字段长度问题本质上是三组关系的错位：字节与字符、定义与实际、PHP层与MySQL层。调试的时候，抓住核心，反复用 strlen 和 SHOW CREATE TABLE 的结果对比两遍，往往比漫无目的地翻阅框架文档要快得多。