MySQL INSERT IGNORE 怎样识别被忽略的行

MySQL 的 INSERT IGNORE 会把一部分本来会中断语句的错误降级为警告，重复键行不会写入，但其他可调整的数据仍可能被写入。要识别“哪些行被忽略”，不能只看语句是否成功：先看受影响行数，再看 Records / Duplicates / Warnings，最后用 SHOW WARNINGS 定位原因。

下面的示例围绕 MySQL 8.4 的多行插入语句展开。示例 SQL 用于说明查询关系和预期判断，请在隔离测试库中执行，不要直接对生产表试验。

官方参考：https://dev.mysql.com/doc/refman/8.4/en/insert.html

先用受影响行数分开成功写入与忽略

最小配方是给重复键场景保留 INSERT IGNORE，但把它当成“继续执行”而不是“所有行都成功”。例如表中已经有 user_id=101，再次插入这一行时，重复键行会被丢弃；同一批里没有冲突的行仍可继续写入。

-- 示例表只用于隔离测试；不要覆盖已有业务表
CREATE TABLE import_user_demo (
  user_id BIGINT NOT NULL PRIMARY KEY,
  nickname VARCHAR(64) NOT NULL
);

-- 其中 user_id=101 假定已经存在，其他新主键用于观察混合结果
INSERT IGNORE INTO import_user_demo (user_id, nickname) VALUES
  (101, '已有用户'),
  (102, '新用户甲'),
  (103, '新用户乙');

-- 立即读取本次 INSERT 的受影响行数；它不是被忽略行的完整名单
SELECT ROW_COUNT() AS affected_rows;

这个最小检查可以告诉我们语句实际影响了多少行，但它不能单独区分“新增了几行”和“因为重复键忽略了几行”。批量导入需要审计时，必须把受影响行数和警告信息放在同一条处理记录里，而不是只记录数据库驱动返回的成功状态。

用 Records、Duplicates、Warnings 找到被忽略原因

多行 INSERT ... VALUES 完成后，MySQL 可以提供一段摘要：Records: N1 Duplicates: N2 Warnings: N3。其中 Records 是处理过的行数，不等于真正插入的行数；Duplicates 指因为已有唯一键或主键而不能插入的行；Warnings 还可能包含非空列收到 NULL、数值越界、字符串截断或非法日期等被调整的情况。

在支持读取语句信息的客户端中，优先保留这三个数字。C API 可以通过 mysql_info() 取得该摘要；如果使用命令行或其他 SQL 客户端，则紧接着执行 SHOW WARNINGS 查看诊断行。

-- 多行写入后立刻查看本次语句产生的警告
INSERT IGNORE INTO import_user_demo (user_id, nickname) VALUES
  (101, '重复用户'),
  (104, '新用户丙'),
  (105, '新用户丁');

-- 诊断区只对应刚刚结束的语句，排查时不要先执行无关 SQL
SHOW COUNT(*) WARNINGS;
SHOW WARNINGS LIMIT 20;

如果警告列表出现重复键代码，说明对应行没有写入；如果出现数据转换或截断警告，则不能把这些行简单归类为“重复数据”。它们可能已经以调整后的值落库。业务日志至少应该保留批次号、输入行数、重复数和警告数；需要逐行回执时，再在应用层按业务唯一键预查或把输入批次写入临时表。

把重复键和数据修正分成两种处理策略

INSERT IGNORE 的优点是批量任务不会因为单行可忽略错误整体中断，代价是错误被降级后容易被忽略。重复键通常表示“目标已经有这条业务记录”，可以记录为跳过；而数值截断、非法日期或 NOT NULL 转换，则更像输入质量问题，不应该和重复键共用一个统计字段。

如果业务要求“存在就更新”，不要把 INSERT IGNORE 当成替代方案。MySQL 文档把 INSERT ... ON DUPLICATE KEY UPDATE 定义为遇到唯一键冲突时更新旧行；它的受影响行数语义也不同。若业务要求覆盖旧行，可以评估 REPLACE，但它不是静默跳过，而是用新行替换旧行，触发器、外键和自增键行为都要单独评估。

另一个边界是 SQL 模式：在严格模式关闭或某些转换场景下，IGNORE 可能让不合法值被调整后继续插入。生产批处理应把警告数视为需要处理的信号，而不是把“没有 SQL 异常”当成数据完整。

批量导入的记录字段怎么设计

一个稳妥的判断顺序是：先保存批次输入行数，再读取语句摘要，紧接着保存警告明细；最后才决定批次是成功、部分跳过还是需要人工重试。这样既能利用 INSERT IGNORE 的批量容错，也不会把被忽略的数据藏在“执行成功”四个字后面。

只有一行插入时，还需要 SHOW WARNINGS 吗？

如果你只关心“是否因为重复键没有写入”，应用层可以结合受影响行数和业务唯一键判断；如果允许其他值被调整，仍应读取警告。单行成功返回不等于没有警告。

能不能用 ROW_COUNT() 直接算出重复行数？

不能可靠地直接相减。你还需要知道本次输入行数，并区分更新、调整、触发器影响及驱动的受影响行数口径。对于重复键统计，优先使用客户端可获得的 Duplicates 摘要或警告明细。

记住这条配方：INSERT IGNORE 只负责让可忽略错误不把批次立刻打断；ROW_COUNT() 观察影响规模；Records / Duplicates / Warnings 解释摘要；SHOW WARNINGS 才能继续定位被忽略或被调整的原因。