MySQL错误码 1406 - 数据太长对于列。

错误信息

Error 1406

数据太长对于列。

你的PHP应用在插入或更新数据时遇到了数据长度超限问题：

                    'pdo_code' => '22001',

                    'db_code' => 1406,

                    'db_error' => 'Data too long for column \'column_name\' at row 1'

解决方案

检查并修改数据库表结构，增加列的长度限制
在应用层进行数据长度验证和截断
使用MySQL的STRICT_TRANS_TABLES模式控制错误行为
检查字符集和校对规则设置
使用SUBSTRING函数在插入前截断超长数据
考虑使用TEXT类型替代VARCHAR类型

PHP数据验证示例代码

                    // 获取表结构信息

                    $tableName = 'your_table';

                    $columnName = 'your_column';

                    // 查询列的最大长度

                    $stmt = $pdo->query("SHOW COLUMNS FROM {$tableName} LIKE '{$columnName}'");

                    $columnInfo = $stmt->fetch(PDO::FETCH_ASSOC);

                    $maxLength = (int) preg_replace('/\D/', '', $columnInfo['Type']);

                    // 数据验证和截断

                    $inputData = '你的输入数据...';

                    if (mb_strlen($inputData) > $maxLength) {

                      // 截断超长数据

                      $truncatedData = mb_substr($inputData, 0, $maxLength);

                      // 记录警告日志

                      error_log("数据截断警告: 列 {$columnName} 数据从 " . mb_strlen($inputData) . " 字符截断到 {$maxLength} 字符");

                    } else {

                      $truncatedData = $inputData;

                    }

                    // 安全插入数据

                    $stmt = $pdo->prepare("INSERT INTO {$tableName} ({$columnName}) VALUES (?)");

                    $stmt->execute([$truncatedData]);

数据超限模拟演示

错误1406通常发生在插入或更新的数据长度超过列定义时：

表结构定义

CREATE TABLE users (

name VARCHAR(10) NOT NULL

);

插入操作

INSERT INTO users (name) VALUES ('这是一个很长的用户名超过了10个字符的限制');

→ 数据长度: 21字符

→ 列限制: 10字符

MySQL检测到数据超限

抛出错误：1406

错误信息: Data too long for column 'name' at row 1

预防措施

1. 数据库设计优化

合理设置VARCHAR列的长度
对于不确定长度的文本使用TEXT类型
考虑字符集的影响（UTF-8字符占用更多空间）
定期审查和调整表结构

2. 应用层防护

在前端进行输入长度验证
在后端进行数据长度检查
实现自动截断机制
添加适当的错误处理和用户提示

3. MySQL配置优化

调整sql_mode设置
使用STRICT_TRANS_TABLES或STRICT_ALL_TABLES
考虑使用IGNORE关键字忽略错误（谨慎使用）

调试工具

使用以下MySQL命令分析表结构：

                    # 查看表结构

                    DESCRIBE table_name;

                    # 或

                    SHOW COLUMNS FROM table_name;

                    # 查看详细的列信息

                    SHOW FULL COLUMNS FROM table_name;

调试要点

重点关注：

列的数据类型和长度限制
字符集和校对规则设置
当前sql_mode配置
实际插入的数据长度

MySQL错误码 1406 分析与解决方案