MySQL mysql_info 如何确认批量 INSERT 实际影响行数：CLIENT_FOUND_ROWS 与返回文本

批量写入订单导入表时，程序常见的误判是只看“影响了几行”，却不知道其中有多少条被唯一键拦下、多少条触发了警告。MySQL C API 可以用 mysql_affected_rows() 读总影响数，再用 mysql_info() 读取批量 INSERT 返回的 Records、Duplicates 和 Warnings 文本，两个结果放在一起才足够判断导入是否完整。

对多值 INSERT ... VALUES，先检查 mysql_query() 是否成功，再读取 mysql_affected_rows() 和 mysql_info()；不要把 affected rows 直接当成“输入行数”，也不要对单值 INSERT 期待非空的 mysql_info()。

批量 INSERT 为什么需要两种结果

假设 import_orders 的 order_no 是唯一键，一次提交 3 行数据，其中 2 行新插入、1 行撞上重复键。mysql_affected_rows() 给的是影响行数，而 mysql_info() 的返回文本则更接近这次语句的处理摘要。

这里的“返回文本”不是给用户展示的自然语言，而是 C API 约定的机器可读字符串。生产代码应按字段名解析，并把未知字段当成兼容变化处理，不能依赖示例里的固定数字。

准备一个能复现重复键的批量写入

先建立一个最小表，并预置一条订单。示例使用 MySQL 8.4 C API 的连接对象 MYSQL，正文只关注结果读取，不把连接密码写入源码。

CREATE TABLE import_orders (
  id BIGINT PRIMARY KEY AUTO_INCREMENT,
  order_no VARCHAR(32) NOT NULL UNIQUE,
  amount DECIMAL(10,2) NOT NULL
);

INSERT INTO import_orders (order_no, amount)
VALUES ('A100', 18.00);

随后执行三值 INSERT，其中 A100 故意与已有唯一键冲突：

INSERT INTO import_orders (order_no, amount)
VALUES ('A100', 20.00), ('A101', 21.00), ('A102', 22.00);

这个场景的价值在于：输入行数、实际新增行数和重复键数量不再相等，正好能检验两个 API 各自提供的证据。

用 mysql_affected_rows 与 mysql_info 读取同一条语句

调用顺序要固定：mysql_query() 返回成功后，马上读取 mysql_affected_rows()，紧接着读取 mysql_info()。中间不要插入新的 SQL。

if (mysql_query(conn,
        "INSERT INTO import_orders (order_no, amount) "
        "VALUES ('A100', 20.00), ('A101', 21.00), ('A102', 22.00)")) {
    fprintf(stderr, "query failed: %s\n", mysql_error(conn));
    return 1;
}

my_ulonglong affected = mysql_affected_rows(conn);
const char *info = mysql_info(conn);
printf("affected=%llu\n", affected);
printf("info=%s\n", info ? info : "(null)");

多值 INSERT 的 mysql_info() 通常会给出类似 Records: 3 Duplicates: 1 Warnings: 0 的摘要。这里的数字只是当前数据的示例，真正写入日志时应保留原始字符串并解析字段。

解析 Records、Duplicates 和 Warnings 时别混淆口径

Records 更接近这次批量语句处理的输入记录数，Duplicates 反映重复键处理数量，Warnings 反映服务器产生的警告数量。它们不是永远都能相加得到最终表行数：例如 INSERT ... ON DUPLICATE KEY UPDATE 还会把更新行为计入 affected rows 的特定语义。

如果业务要求“3 行全部新增”，可以采用如下判断顺序：

1. 先确认 mysql_query() 成功。
2. 解析 mysql_info() 的 Records、Duplicates、Warnings。
3. 要求 Records 等于本批输入数，且 Duplicates 与 Warnings 都为 0；满足时批次可标记为接受。
4. 把不满足条件的批次标为需要复核，而不是仅凭 affected rows 判定成功。

CLIENT_FOUND_ROWS 什么时候会改变结果

CLIENT_FOUND_ROWS 是连接到 mysqld 时传给 mysql_real_connect() 的客户端标志。它主要改变 UPDATE 的 affected rows：默认更关注真正改变的行，启用后则按 WHERE 匹配到的行计算；在重复键更新且新值与旧值相同时，也会改变 affected rows 的报告。

因此，不要把这个标志当成“让批量 INSERT 返回真实新增数”的开关。批量 INSERT 的详细摘要仍应读取 mysql_info()，而连接选项的选择应由调用方对 UPDATE/重复键更新的业务口径决定。

运行检查与常见边界

• 单值 INSERT：MySQL 文档说明 mysql_info() 对 INSERT ... VALUES 只有多值形式才返回非 NULL 信息。
• 读取太晚：新的查询可能让“最近一条语句”的上下文不再是批量 INSERT，应在原语句后立即读取。
• 警告不等于成功：若使用 INSERT IGNORE，错误可能变成警告，必须把 Warnings 纳入批次结果。
• 字符解析：返回文本可能随语句类型变化，按字段名和空格解析，避免按固定位置截取。

相关问题

mysql_info() 返回 NULL 是不是 INSERT 失败？

不一定。它表示当前语句没有可用的附加信息；先看 mysql_query() 的返回值和 mysql_error()。

mysql_affected_rows() 能代替 mysql_info() 吗？

不能。它适合读取影响行数，但无法单独告诉你 Records、Duplicates 和 Warnings 的拆分。

批量 INSERT 后如何确认没有重复键？

读取 mysql_info() 并确认 Duplicates: 0；若业务还要求无警告，再同时确认 Warnings: 0。

把批次结果落成可复查日志

一个可靠的批量导入日志至少保留 SQL 类型、输入行数、affected、原始 mysql_info() 文本和最终判定。这样后续发现导入少行时，能区分重复键、警告还是调用顺序错误，而不是重新猜测数据库当时做了什么。