MySQL 插入失败需按“语法→权限→约束→数据→环境”顺序排查：主键 / 唯一索引冲突报 ERROR 1062；字段类型或长度不匹配引发 ERROR 1265/1366；外键或 NOT NULL 限制未满足导致 ERROR 1452；权限不足或连接异常触发 ERROR 1142 等。
MySQL 数据插入失败通常不是单一原因导致的，而是由约束校验、权限配置、数据格式、连接状态等多方面问题共同作用的结果。定位时建议按“语法→权限→约束→数据→环境”顺序排查，避免盲目修改。
主键或唯一索引冲突
当插入的记录在主键（PRIMARY KEY）或带 UNIQUE 约束的字段上与已有数据重复时，MySQL 会直接报错 ERROR 1062: Duplicate entry。例如向用户表插入已存在的手机号或 邮箱。
- 检查目标字段是否设置了 UNIQUE 或 PRIMARY KEY
- 执行 SELECT * FROM table WHERE column = ‘value’ 确认是否存在重复值
- 如需忽略重复可改用 INSERT IGNORE，或用 ON DUPLICATE KEY UPDATE 做更新处理
字段类型或长度不匹配
插入值超出定义范围（如 INT 超过 2147483647）、字符串超长（VARCHAR(10) 插入 15 个字符）、时间格式错误（’2025-13-01’）等，都会触发 ERROR 1265（Data truncated） 或 ERROR 1366（Incorrect string value）。
- 用 DESCRIBE table_name 查看字段类型、长度和是否允许 NULL
- 注意字符集兼容性：utf8mb4 才支持 emoji，旧 utf8 不行
- 插入时间 / 日期前先用 STR_TO_DATE() 或服务端做格式校验
外键约束或非空限制未满足
若表有外键（FOREIGN KEY），而插入的关联字段值在父表中不存在，会报 ERROR 1452: Cannot add or update a child row。同理，NOT NULL 字段传了 NULL 或空字符串（且字段未设默认值）也会失败。
- 确认外键字段值已在父表对应主键中存在
- 检查 INSERT 语句是否遗漏了 NOT NULL 字段，或显式传了 NULL
- 可通过 SHOW CREATE TABLE table_name 查看完整约束定义
权限不足或连接异常
用户无 INSERT 权限、连接被中断、事务未提交或锁表（如被 ALTER TABLE 阻塞）都可能导致写入失败。错误提示可能为 ERROR 1142: INSERT command denied 或超时类报错（如 ERROR 2006 / ERROR 2013）。
- 用 SHOW GRANTS FOR ‘user’@’host’ 检查 INSERT 权限
- 执行 SHOW PROCESSLIST 查看是否有长事务或锁等待
- 确认客户端连接是否活跃，必要时重连或调整 wait_timeout 设置
不复杂但容易忽略
