MySQL GET DIAGNOSTICS 怎样在存储过程中读取影响行数

在 MySQL 存储过程中，想拿到刚刚一条 UPDATE、INSERT 或 DELETE 实际影响的行数，可以在语句后立刻执行 GET DIAGNOSTICS n = ROW_COUNT，把结果保存到局部变量。关键是不要在读取前再执行会刷新诊断区的语句。

官方地址：https://dev.mysql.com/doc/refman/8.4/en/get-diagnostics.html

最稳妥的写法是：DML 语句结束后立即读取 ROW_COUNT，再把变量用于日志、审计或 IF 分支。GET DIAGNOSTICS 取到的 ROW_COUNT 与 ROW_COUNT() 的值相同，但不需要再执行一个查询来取结果。

先分清诊断区和 ROW_COUNT()

MySQL 会把 SQL 执行产生的语句信息放进 diagnostics area，其中的 ROW_COUNT 表示受影响的行数。GET DIAGNOSTICS 可以把它直接写入存储过程局部变量、参数或用户变量；语句信息和错误条件信息不能在同一条 GET DIAGNOSTICS 中混取。

ROW_COUNT() 是函数调用，适合在客户端或普通 SQL 中快速查看；存储过程中如果还要记录结果或继续判断，直接把诊断区值接到变量会更清晰。

在 DML 后立即接收 ROW_COUNT

下面的过程更新一批待处理订单，然后把实际改变的行数写入输出参数。示例中的中文注释只说明关键边界，没有把每一行都机械翻译。

DELIMITER //

CREATE PROCEDURE mark_orders_done(
    IN p_customer_id BIGINT,
    OUT p_changed_rows INT
)
BEGIN
    DECLARE v_changed_rows INT DEFAULT 0;

    -- 只更新待处理订单，避免重复执行时扩大影响范围
    UPDATE orders
       SET status = 'done', updated_at = CURRENT_TIMESTAMP
     WHERE customer_id = p_customer_id
       AND status = 'pending';

    -- 必须紧跟 UPDATE，先把诊断区的行数保存下来
    GET DIAGNOSTICS v_changed_rows = ROW_COUNT;

    -- 把结果交给调用方，后续语句不再依赖易被覆盖的诊断区
    SET p_changed_rows = v_changed_rows;
END//

DELIMITER ;

如果本次确实更新了 3 行，p_changed_rows 就是 3；如果条件没有命中，结果就是 0。这个变量可以继续写入审计表、返回给应用层，或者参与下一步业务判断。

把影响行数接入存储过程分支

读取结果后再判断，过程的职责会更明确：0 行通常表示没有待处理数据，不一定是 SQL 失败；大于 0 表示发生了实际变更；如果业务要求必须改满指定数量，则可以把不足情况单独记录。

-- 变量声明必须位于存储程序块的前部
DECLARE v_changed_rows INT DEFAULT 0;

-- 执行目标 DML
DELETE FROM session_tokens
 WHERE user_id = p_user_id
   AND expires_at 

如果还要读取错误码或消息，另写一条 GET DIAGNOSTICS CONDITION ...，并在异常处理器中按实际上下文选择 CURRENT 或 STACKED。本文只聚焦成功执行后的影响行数，不把异常条件栈混入同一个判断。

四个容易误判的边界

1. 不要把匹配行等同于变更行。普通 UPDATE 的影响行数默认更接近实际发生变化的行数；客户端连接若启用 CLIENT_FOUND_ROWS，相关返回语义会变成匹配行数，应用和过程的预期要统一。
2. 不要在读取前插入调试语句。为了打印结果而先执行其他 SQL，可能让你拿到的不是目标 DML 的诊断信息。先读入变量，再输出或记录。
3. SELECT 结果集不是普通影响行数。对返回结果集的 SELECT，ROW_COUNT() 通常返回 -1；不要把它当成 UPDATE 的行数语义。
4. DDL 不适合用它判断业务变更。例如 CREATE TABLE、DROP TABLE 的 ROW_COUNT 语义为 0；如果要判断 DDL 是否成功，应处理执行错误，而不是等待一个业务行数。

结论与速查

这套流程可以记成四步：执行目标 DML → 立即 GET DIAGNOSTICS 变量 = ROW_COUNT → 用变量做分支或记录 → 再执行其他 SQL。需要临时查看时可以用 ROW_COUNT()，需要在存储过程中稳定传递结果时，优先保存到局部变量。

常见问题：

• GET DIAGNOSTICS 能在存储过程外使用吗？可以，MySQL 文档说明 CURRENT 形式可在 handler 外检查上一条 SQL 的诊断信息。
• 能不能在一条 GET DIAGNOSTICS 里同时读 ROW_COUNT 和错误消息？不能。语句信息与条件信息要分开读取。
• 读取 ROW_COUNT 后还能多次使用吗？可以把它保存到变量后重复使用；不要反复依赖会被后续语句刷新或覆盖的诊断区。