MySQL插入报“Data truncated”或“Out of range”是字段类型与值不兼容所致，需检查sql_mode是否启用严格模式，并核对VARCHAR长度、TINYINT范围、DECIMAL精度、DATETIME合法性及ENUM值匹配等。

MySQL插入时提示“Data truncated for column”或“Out of range value”

这类错误本质是字段类型与传入值不兼容，不是语法错误，而是数据语义冲突。MySQL默认开启严格模式前会静默截断或转为默认值，开启后才报错——所以先确认你的 sql_mode 是否包含 STRICT_TRANS_TABLES 或 STRICT_ALL_TABLES。

• 用 SELECT @@sql_mode; 查看当前模式
• 临时修改：执行 SET sql_mode = 'STRICT_TRANS_TABLES';
• 生产环境建议在配置文件 my.cnf 中设置 sql_mode = STRICT_TRANS_TABLES,NO_ENGINE_SUBSTITUTION

常见字段类型不匹配场景及修复方式

不是所有“看着像”的值都能存进对应字段，尤其要注意隐式转换边界。

• VARCHAR(10) 存不下 11 个 UTF8 字符（如含 emoji，一个 ? 占 4 字节，实际最多存 2 个）→ 改用 VARCHAR(32) 或确认字符集（utf8mb4 下按字节数算）
• TINYINT 范围是 -128～127，但常被误当“布尔”用；若插入 255，严格模式下直接报 Out of range value → 改用 TINYINT UNSIGNED（0～255），或明确业务是否真需要 0/1 就够了
• DECIMAL(5,2) 最多存 3 位整数 + 2 位小数（如 999.99），插 1000.00 就越界 → 检查业务最大值，调大整数位，例如 DECIMAL(8,2)
• DATETIME 不接受 '2025-02-30' 或 '0000-00-00'（除非禁用 NO_ZERO_DATE）→ 用程序校验日期合法性，别依赖 MySQL 自动修正

INSERT … SELECT 或批量导入时字段对不齐

从其他表或 CSV 导入时，字段顺序、数量、类型不一致极易触发截断或类型转换失败。

• 避免裸写 INSERT INTO t1 SELECT * FROM t2，务必显式列出字段：INSERT INTO t1 (a, b, c) SELECT x, y, z FROM t2
• CSV 导入用 LOAD DATA INFILE 时，检查 FIELDS TERMINATED BY 和 LINES TERMINATED BY 是否匹配真实分隔符（Windows 换行是 \r\n，Linux 是 \n）
• 目标字段是 ENUM('on','off')，但源数据有 'enabled' → MySQL 插入空字符串或默认首项，严格模式下直接报错 → 预处理源数据，或改用 VARCHAR + 应用层约束

SELECT 
  COLUMN_NAME, 
  DATA_TYPE, 
  CHARACTER_MAXIMUM_LENGTH, 
  NUMERIC_PRECISION, 
  NUMERIC_SCALE, 
  IS_NULLABLE 
FROM INFORMATION_SCHEMA.COLUMNS 
WHERE TABLE_SCHEMA = 'your_db' 
  AND TABLE_NAME = 'your_table' 
ORDER BY ORDINAL_POSITION;

类型不匹配的坑往往藏在开发和测试环境的宽松模式里，上线后一开严格模式就暴露。最稳妥的做法：建表时就按业务上限设宽，导入前用 DESCRIBE table_name 和上述查询核对字段定义，别信“应该没问题”。