问题描述
在RDS MySQL数据库中写入数据时，出现如下报错：
Error 1406: Data too long for column 'xxx'问题原因
字段长度限制
当表结构中定义的字段为字符类型（如
CHAR或VARCHAR），并且指定了最大长度限制时，如果写入的数据长度超过该限制，则会触发此错误。sql_mode模式影响sql_mode的配置决定了MySQL对超出字段长度数据的处理方式：当MySQL数据库启用了严格模式（
STRICT_TRANS_TABLES或STRICT_ALL_TABLES），如果写入的数据超出字段定义的长度限制，MySQL会直接报错并拒绝写入。当MySQL数据库未启用严格模式，MySQL允许写入超出长度限制的数据，但会截断超出部分，并记录警告信息，此时数据并不完整。
客户端差异导致报错表现不同
不同客户端可能设置了不同的
sql_mode值，且不同客户端写入的数据长度不同，只有超出字段定义长度的写入才会触发问题。例如：客户端A启用了严格模式，写入超长数据会报错。
客户端B未启用严格模式，写入超长数据会被截断且不报错，但数据并不完整。
示例如下：
-- 创建表t1，包含两个字段id（主键，类型为INT，不能为空）、name（类型为VARCHAR，最大长度为5个字符）。
CREATE TABLE t1 (
id INT NOT NULL PRIMARY KEY,
name VARCHAR(5)
);
-- 输出：Query OK, 0 rows affected (0.01 sec)
-- 查看当前数据库的SQL模式（sql_mode），sql_mode决定了MySQL的行为模式，例如是否启用严格模式。
SHOW VARIABLES LIKE 'sql_mode';
-- 输出：返回STRICT_TRANS_TABLES表示启用了严格模式。
-- +---------------+-----------------------------------------------------------------------------------------------------------------------+
-- | Variable_name | Value |
-- +---------------+-----------------------------------------------------------------------------------------------------------------------+
-- | sql_mode | ONLY_FULL_GROUP_BY,STRICT_TRANS_TABLES,NO_ZERO_IN_DATE,NO_ZERO_DATE,ERROR_FOR_DIVISION_BY_ZERO,NO_ENGINE_SUBSTITUTION |
-- +---------------+-----------------------------------------------------------------------------------------------------------------------+
-- 1 row in set (0.00 sec)
-- 尝试插入一条数据，其中name字段的值为'aaaaaa'（6个字符），超出字段定义的最大长度（5个字符）。
INSERT INTO t1 VALUES (1, 'aaaaaa');
-- 输出：ERROR 1406 (22001): Data too long for column 'name' at row 1
-- 原因：由于启用了严格模式 (STRICT_TRANS_TABLES)，MySQL报错并拒绝插入超出长度限制的数据。
-- 查询表t1的内容，确认是否成功插入数据。
SELECT * FROM t1;
-- 输出：Empty set (0.00 sec)
-- 原因：由于上一步插入失败，因此表中没有数据。
解决方案
调整字段长度（推荐）
修改表结构，增加字段的长度限制，以适配写入数据的最大长度需求。例如：
ALTER TABLE t1 MODIFY COLUMN name VARCHAR(10);调整
sql_mode模式（不推荐）如果无法修改表结构，可以通过调整
sql_mode参数来禁用严格模式规避报错。禁用严格模式后，写入超长数据不会报错，但超出部分会被截断，可能导致数据不完整。由于该方法存在数据丢失风险，因此仅适用于临时调试或非关键业务场景。例如：-- 去掉STRICT_TRANS_TABLES严格事务模式 mysql> set sql_mode='ONLY_FULL_GROUP_BY,NO_ZERO_IN_DATE,NO_ZERO_DATE,ERROR_FOR_DIVISION_BY_ZERO,NO_ENGINE_SUBSTITUTION'; Query OK, 0 rows affected, 1 warning (0.00 sec) -- 再次插入超出字段定义长度的数据可以插入成功，但MySQL客户端写入可以看到有warning提示 mysql> insert into t1 values (2,'aaaaaa'); Query OK, 1 row affected, 1 warning (0.00 sec) -- warning提示中显示name字段数据被截断了 mysql> show warnings; +---------+------+-------------------------------------------+ | Level | Code | Message | +---------+------+-------------------------------------------+ | Warning | 1265 | Data truncated for column 'name' at row 1 | +---------+------+-------------------------------------------+ 1 row in set (0.00 sec)
统一客户端
sql_mode配置确保所有客户端使用一致的
sql_mode配置，避免因客户端差异导致的行为不一致。
使用建议
建议您开启SQL洞察和审计功能，以便记录执行失败的SQL语句。
在审计页面中，您可以通过勾选执行状态为失败来筛选出执行失败的SQL记录，失败的SQL会展示在页面下方的日志列表中，状态列除了展示SQL执行失败外，还会记录失败码，您还可根据错误码检索失败原因。
适用于
RDS MySQL