根本原因不是中文“太长”，而是字节长度算错：varchar(255)在utf8mb4下最多存1020字节，一个中文占4字节，但连接编码错误（如latin1）导致mysql解码字节数膨胀而超限。
根本原因不是中文“太长”，而是字节长度算错了——VARCHAR(255)在utf8mb4下最多存 1020 字节，但一个中文占 4 字节，而你插入时用的连接编码可能是latin1或gbk，导致 MySQL 把同一个字符串解码成不同字节数，校验时直接超限。
查字段真实字节容量：别信“255个字符”这个数字
VARCHAR(255)不等于能塞 255 个中文。它限制的是字符数，但每个字符占多少字节，取决于列的字符集：
- 如果列是
utf8mb4（推荐），一个汉字、emoji 或补充平面字符占 4 字节 → 实际上限 = 255 × 4 = 1020 字节 - 如果列是
utf8（旧版三字节 UTF-8），大部分中文占 3 字节 → 上限 ≈ 765 字节 - 如果列是
latin1，中文根本存不了，会变成问号或乱码，但插入时可能因错误解码膨胀字节数，触发Data too long
执行这两条命令确认：
DESCRIBE your_table;
SHOW CREATE TABLE your_table;
重点看 description 列有没有显式指定 CHARSET 和 COLLATE；哪怕表默认是 utf8mb4，单列也可能被建表语句覆盖成别的编码。
查当前连接编码：CMD 手动成功但脚本失败，90% 是这里崩了
你在终端手动 INSERT 成功，但用 mysql -u root -p db 就报错？大概率是 SQL 文件保存为 UTF-8，而 <a style="color:#f60; text-decoration:underline;" title="mysql" href="https://m.php.cn/zt/15713.html" target="_blank">mysql</a> 客户端没指定编码，按服务器默认（比如 <code>latin1）去读文件，把一个中文当 1 字节解析，结果实际字节流翻倍甚至错乱，校验时直接超 1020。
- 查当前 session 编码：
SELECT @@character_set_client, @@character_set_connection, @@character_set_results; - 导入时强制指定：
mysql --default-character-set=utf8mb4 -u root -p db - Java JDBC 连接串加参数：
?characterEncoding=utf8mb4&useUnicode=true
注意：LENGTH() 返回字节数，CHAR_LENGTH() 返回字符数——报错依据永远是 LENGTH() 值，不是你肉眼数的汉字个数。
TEXT 类型也报 Data too long？那是真超了 65535 字节
TEXT 不是“无限大”，它上限是 65535 字节（约 21845 个 utf8mb4 中文）。如果你往 TEXT 字段插 Base64 图片、大段富文本或日志，很容易踩到这个硬限制。
- 先确认数据真实字节数：
SELECT LENGTH(your_column) FROM your_table ORDER BY LENGTH(your_column) DESC LIMIT 1; - 不够用就升级类型：
ALTER TABLE your_table MODIFY COLUMN your_column MEDIUMTEXT; - JDBC 驱动会在发送前主动校验长度，所以错误出现在应用层而非 MySQL Server 日志里
别指望靠改 sql_mode 关掉严格模式来绕过——非严格模式下对 VARCHAR 会静默截断（警告 Data truncated），但 TEXT 不截，直接拒绝写入。
ORM 模型没同步、索引前缀没更新，扩了字段也白搭
执行了 ALTER TABLE MODIFY COLUMN description VARCHAR(500) 还报错？可能卡在这几个隐形环节：
- SQLAlchemy / Django ORM 缓存了旧表结构，生成的 INSERT 语句仍按
VARCHAR(255)绑定参数，驱动提前报错 - 该字段上有前缀索引，比如
INDEX(description(100))，虽然字段扩到 500，但索引只覆盖前 100 字符，某些唯一约束或排序逻辑会间接触发长度校验 - 表行总宽超 65535 字节（InnoDB 单行限制），扩一个字段反而让整行撑爆，报错可能指向其他列
改字段前务必跑这三句：
SELECT MAX(LENGTH(description)) FROM your_table;
SHOW INDEX FROM your_table WHERE Column_name = 'description';
SELECT SUM(CHARACTER_MAXIMUM_LENGTH) FROM information_schema.COLUMNS WHERE TABLE_NAME = 'your_table' AND DATA_TYPE = 'varchar';
最常被跳过的动作是：没验证现有数据是否已超新长度，也没检查连接编码和 ORM 元信息是否同步——光改 DDL，不碰 runtime 层，问题照旧。
