MySQL INSERT IGNORE 为什么吞掉错误：重复键、数据截断与告警验证

夜间导入订单时，任务日志显示“成功写入 9980 行”，但第二天抽查发现有几条金额少了小数位。问题不一定出在事务重试，批处理里那句 INSERT IGNORE 可能已经把原本应该暴露的错误降成了告警。

先看一个最小实验：成功不代表没有问题

下面的表故意把 code 设为唯一键，把 amount 限制为两位小数。第二条数据重复，第三条数据超出字段精度：

CREATE TABLE import_demo (
  id BIGINT PRIMARY KEY AUTO_INCREMENT,
  code VARCHAR(20) NOT NULL UNIQUE,
  amount DECIMAL(10, 2) NOT NULL
);

INSERT IGNORE INTO import_demo (code, amount) VALUES
  ('A-100', 12.30),
  ('A-100', 18.50),
  ('A-101', 999999999.999);

SELECT ROW_COUNT();
SHOW WARNINGS;

这里最容易误判的是客户端只显示了“Query OK”。重复键那一行可能没有插入，超出精度的值也可能被转换后写入，具体结果取决于服务器版本和 SQL mode。真正需要看的，是受影响行数、告警内容，以及数据库里最后落下的值。

为什么重复键会被跳过

对唯一索引或主键来说，普通 INSERT 遇到冲突会直接报错，并让调用方决定更新、跳过还是回滚。加上 IGNORE 后，MySQL 会把一部分可处理的错误转成告警，让语句继续处理后续行。

这对“重复导入同一批幂等数据”有用，但它没有告诉你业务上这条重复记录是否应该被覆盖。尤其是批量同步，重复键可能意味着上游版本落后、主键映射错误，静默跳过反而会掩盖数据延迟。

重复键与“更新已有行”不是一回事

INSERT IGNORE 不会把新值自动更新到旧行。若业务意图是“存在则更新”，应该明确使用 INSERT ... ON DUPLICATE KEY UPDATE，并记录更新前后的版本或时间戳。若意图是“只插入新数据”，则要把被跳过的数量纳入监控。

数据截断为什么也可能变成告警

重复键比较直观，数据质量问题更危险。字符过长、数字精度超出、日期格式不合法、隐式类型转换，都可能在宽松 SQL mode 下被调整后写入；IGNORE 会让这类问题更容易被忽略。

例如金额字段原本要求两位小数，导入值却带有更多小数位。即使最终只差几分钱，后续对账也可能无法解释。不要只在开发环境看过一次结果就下结论，因为线上实例的 @@sql_mode 可能不同：

SELECT @@sql_mode, VERSION();
SELECT code, amount
FROM import_demo
WHERE code IN ('A-100', 'A-101');

这里别急着把 SQL mode 调成某个固定字符串。先确认应用、迁移工具和连接池实际使用的会话设置，再用同一份脏数据做回归。数据库约束、SQL mode 与导入工具三者不一致，才是很多“本地没问题、线上少数据”的根源。

导入完成后，至少做三次核对

批处理代码可以保留 INSERT IGNORE，但不能把它当成最终结果。一个可操作的检查顺序如下：

1. 读取 ROW_COUNT()，与输入行数、预期新增数和重复数对比。
2. 紧接着读取 SHOW WARNINGS，按 warning code 分类统计重复、截断和转换问题。
3. 对金额、状态、外部单号等关键字段做抽样查询，确认落库值没有被静默改写。

什么时候该换回普通 INSERT

如果订单金额、库存数量、支付状态或外部流水号发生静默变化，后果比一次导入失败更难排查，这些场景不适合用 IGNORE 掩盖错误。可以先把数据写入临时表，完成类型、范围、唯一性校验，再将合格记录写入正式表。

如果只是重复投递同一个不可变事件，且重复数量有明确监控，INSERT IGNORE 可以作为幂等策略的一部分。关键是把“允许跳过什么”写进接口契约，而不是让数据库替业务做决定。

常见问题

INSERT IGNORE 会忽略所有错误吗？

不会。它只会对部分可处理错误改变行为，语法错误、连接故障等问题仍会失败；具体降级范围还与表约束、版本和 SQL mode 有关。

为什么 ROW_COUNT() 和输入行数对不上？

可能包含重复键跳过、更新行为差异或被转换的数据。应结合 SHOW WARNINGS 和落库抽样，不要只看一个数字。

能不能用 INSERT IGNORE 做数据清洗？

不建议。清洗应有明确的规则、拒绝记录和可追溯结果；IGNORE 更适合已知且可接受的幂等重复，而不是隐藏未知脏数据。

把“成功写入”改成可解释的结果

INSERT IGNORE 解决的是语句如何继续执行，不是数据是否值得接受。对导入任务来说，成功标准至少要包含新增数、跳过数、告警数和关键字段抽样结果。这样下一次出现“任务成功但数据不对”时，日志里才有足够证据定位原因。