INSERT失败主因有四：1.主键/唯一索引冲突报ERROR 1062；2.字段类型或长度不匹配在严格模式下报ERROR 1406/1366；3.外键引用不存在父记录报ERROR 1452；4.权限不足或MyISAM引擎限制导致中断。
主键或唯一索引冲突导致 INSERT 失败
最常见的失败原因是试图插入重复的 PRIMARY KEY 或 UNIQUE 字段值。MySQL 会直接报错 ERROR 1062 (23000): Duplicate entry 'xxx' for key 'yyy'。
- 检查表结构：
SHOW CREATE TABLE table_name;确认哪些字段有UNIQUE或PRIMARY KEY约束 - 排查已有数据：
SELECT * FROM table_name WHERE column_name = 'value'; - 避免硬插：改用
INSERT IGNORE（静默跳过）、REPLACE INTO（删旧插新）或INSERT ... ON DUPLICATE KEY UPDATE（冲突时更新） - 注意：使用
INSERT IGNORE会吞掉其他错误（如字段超长），不推荐在调试阶段使用
字段类型或长度不匹配引发写入异常
比如向 VARCHAR(10) 插入 15 个字符，或向 INT 插入字符串 'abc'，MySQL 在严格模式下会拒绝写入并报错 ERROR 1406 (22001): Data too long 或 ERROR 1366 (HY000): Incorrect integer value。
- 确认当前 SQL 模式：
SELECT @@sql_mode;，若含STRICT_TRANS_TABLES或STRICT_ALL_TABLES，则类型校验严格 - 查看字段定义：
DESCRIBE table_name;，重点核对Type和Null列 - 字符串插入前做截断或长度校验；数值字段确保传入的是合法数字（不是空字符串或
NULL字符串） - 开发环境建议开启严格模式，生产环境也别关——否则可能隐式转成 0 或截断，埋下数据质量隐患
外键约束（FOREIGN KEY）校验失败
当插入记录引用了不存在的父表主键时，MySQL 报错 ERROR 1452 (23000): Cannot add or update a child row: a foreign key constraint fails。
- 先查外键定义：
SELECT CONSTRAINT_NAME, COLUMN_NAME, REFERENCED_TABLE_NAME, REFERENCED_COLUMN_NAME FROM INFORMATION_SCHEMA.KEY_COLUMN_USAGE WHERE TABLE_NAME = 'child_table' AND CONSTRAINT_SCHEMA = DATABASE(); - 确认被引用的父表中是否存在对应记录，例如：
SELECT id FROM parent_table WHERE id = 123; - 插入顺序很重要：必须先有父记录，再插子记录；批量导入时尤其容易出错
- 临时禁用外键检查（仅限调试/迁移）：
SET FOREIGN_KEY_CHECKS = 0;，完事后记得设回1
权限不足或存储引擎限制导致写入中断
用户没有 INSERT 权限时，报错 ERROR 1142 (42000): INSERT command denied to user；而使用 MyISAM 引擎时，如果磁盘满或达到 max_allowed_packet 限制，也会静默失败或报错 ERROR 2006 (HY000): MySQL server has gone away。
- 检查权限：
SHOW GRANTS FOR CURRENT_USER;，确保包含GRANT INSERT ON db.table TO 'user'@'%'; - 确认引擎类型：
SHOW TABLE STATUS LIKE 'table_name';，优先用InnoDB（支持事务、行锁、外键） - 查磁盘空间：
df -h（Linux）或看 MySQL 错误日志中是否有disk full提示 - 调大包体限制（需重启或动态设置）：
SET GLOBAL max_allowed_packet = 64*1024*1024;，但要同步修改配置文件中的max_allowed_packet
SELECT t.TABLE_NAME, t.ENGINE, t.TABLE_ROWS, ROUND(((t.DATA_LENGTH + t.INDEX_LENGTH) / 1024 / 1024), 2) AS size_mb FROM information_schema.TABLES t WHERE t.TABLE_SCHEMA = DATABASE() AND t.TABLE_NAME = 'your_table';
实际排障时，别只盯着 SQL 语句本身——先看 MySQL 错误日志（通常是 /var/log/mysql/error.log 或由 log_error 配置项指定），里面常有比客户端提示更具体的上下文，比如死锁链路、磁盘 I/O 超时、连接被 kill 的原因。很多“插入失败”根本不是语法问题，而是资源卡住了。
