INSERT IGNORE 无法记录错误详情,因其静默忽略所有错误(包括主键冲突、字段超长、类型不匹配等),不触发错误日志、不返回具体错误码和消息,导致无法审计、重试或告警。

MySQL INSERT IGNORE 为什么不能记录错误详情
INSERT IGNORE 确实能跳过主键/唯一键冲突的行,但它把错误“吞”掉了——mysql_affected_rows() 返回 0,日志里连哪一行出错、为什么错都看不到。它适合“不关心失败原因,只要不报错”的场景,比如幂等写入缓存表;但一旦要审计、重试或告警,这条路就走不通。
- 它不触发
ON DUPLICATE KEY UPDATE,也不进error log - 所有错误(不只是重复键)都被静默忽略,比如字段超长、类型不匹配也会消失
- 无法区分“本该跳过”和“本不该发生却跳过了”的问题
用 INSERT ... ON DUPLICATE KEY UPDATE + 错误日志表兜底
真正可控的做法是:先尝试插入,冲突时转存到日志表。这需要两步原子操作,靠存储过程或应用层事务封装。核心不是避免错误,而是让错误可追溯。
- 建一张结构一致的错误日志表,加
error_code、error_message、insert_time字段 - 在应用中捕获
mysqli_sql_exception或psycopg2.IntegrityError,解析sqlstate和errno - 把原始数据 + 错误信息一起
INSERT INTO error_log_table,别用INSERT IGNORE写日志表——否则日志也丢
示例(PHP PDO):
try {
$stmt = $pdo->prepare("INSERT INTO users (id, name) VALUES (?, ?)");
$stmt->execute([$id, $name]);
} catch (PDOException $e) {
if ($e->getCode() === '23000') { // SQLSTATE for integrity constraint
$log = $pdo->prepare("INSERT INTO users_error_log (id, name, error_code, error_message) VALUES (?, ?, ?, ?)");
$log->execute([$id, $name, $e->getCode(), $e->getMessage()]);
}
}
PostgreSQL 的 ON CONFLICT DO NOTHING 不够用?加 RETURNING + CTE 补足
ON CONFLICT DO NOTHING 同样静默,但 PostgreSQL 支持 RETURNING,配合 WITH 可以把“被忽略的行”捞出来。这是少数不用改应用逻辑就能拿到失败数据的方案。
- 必须显式指定冲突目标(如
ON CONFLICT (id)),不能只写ON CONFLICT -
RETURNING *只返回成功插入的行;要捕获失败行,得用 CTE 先查再插 - 性能有损耗:每批插入多一次
SELECT检查,大数据量时注意索引覆盖
示例:
WITH input AS ( SELECT unnest(ARRAY[1,2,3]) AS id, unnest(ARRAY['a','b','c']) AS name ), conflicts AS ( SELECT i.* FROM input i INNER JOIN users u ON i.id = u.id ) INSERT INTO users SELECT * FROM input ON CONFLICT (id) DO NOTHING RETURNING id; -- 这里只返回成功行要记录失败行,得额外
INSERT INTO error_log SELECT * FROM conflicts
批量插入时别依赖单条语句的错误处理
用 LOAD DATA INFILE 或 COPY 批量导入时,哪怕加了 IGNORE 或 ON ERROR CONTINUE,错误定位粒度仍是“整批”,没法知道第几行坏了。生产环境必须前置校验。
- 导入前用
SELECT COUNT(*)检查源数据中重复id的数量 - 导出阶段就加
WHERE NOT EXISTS (SELECT 1 FROM target WHERE target.id = source.id)过滤 - 对超大文件,拆成 1k–5k 行/批,每批单独事务 + 错误捕获,避免一错全滚
最容易被忽略的是字符集隐式转换导致的“伪重复”:比如 utf8mb4 列存了 emoji,但客户端用 latin1 连接,插入时被截断成空字符串,多条都变为空,触发唯一键冲突。这种错误不会报 1062 Duplicate entry,而是报 1366 Incorrect string value,但日志表如果没存原始字节流,就再也复现不了。

















