PAYATHON 2026

MySQL 存储过程执行时提示 Query interrupted,如何排查?

数据小陈

这段存储过程需要先解决参数与列同名的问题。devotion_id = devotion_id 等条件没有明确区分表字段和输入参数,无法按预期筛选记录。此外,保存 NOW() 的局部变量声明为 DATE,会丢失时分秒。

这些问题不能直接说明 Query interrupted 的原因。应先修正查询,再结合完整错误信息和执行现场排查中断原因。

为什么当前筛选条件有问题?

在 MySQL 存储程序中,参数与列同名时,未限定的名称会优先解释为参数。因此:

WHERE devotion_id = devotion_id
  AND user_id = user_id
  AND repetition_number = repetition_number

当前调用传入的参数均非 NULL,上述条件相当于将参数与自身比较,不能筛选出指定记录。

这可能导致子查询读取多条记录,而 CASE WHEN (SELECT ...) 中的子查询只能返回一个值。如果返回多行,通常会出现 Subquery returns more than 1 row,与语句被中断是不同的问题。

建议为参数添加 p_ 前缀,为局部变量添加 v_ 前缀,并用表别名限定字段:

WHERE r.devotion_id = p_devotion_id
  AND r.user_id = p_user_id
  AND r.repetition_number = p_repetition_number

原来的 UPDATE 已为左侧字段添加别名,但右侧仍混用了同名参数和局部变量。统一命名可以避免误读。

如何修改存储过程?

可以通过关联更新计算完成状态,省去单独读取 start_time 的标量子查询。下面的示例保留了原代码的规则:只有 conditionally_complete = 1 且完成状态为 2 时,才写入 conditionally_complete_time。

DELIMITER $$

CREATE PROCEDURE finish_repetition(
    IN p_devotion_id INT,
    IN p_user_id INT,
    IN p_repetition_number INT,
    IN p_conditionally_complete INT
)
BEGIN
    DECLARE v_now DATETIME;
    DECLARE v_day_start DATETIME;

    SET v_now = NOW();
    SET v_day_start = DATE(v_now);

    UPDATE devotions AS a
    INNER JOIN repetitions AS b
        ON b.devotion_id = a.devotion_id
       AND b.user_id = a.user_id
    SET
        a.last_refresh_time = v_now,
        b.is_completed = CASE
            WHEN b.start_time >= v_day_start
             AND b.start_time < v_day_start + INTERVAL 1 DAY
            THEN 1
            ELSE 2
        END,
        b.end_time = IF(
            p_conditionally_complete != 1,
            v_now,
            NULL
        ),
        b.conditionally_complete_time = CASE
            WHEN p_conditionally_complete = 1 THEN
                CASE
                    WHEN b.start_time >= v_day_start
                     AND b.start_time < v_day_start + INTERVAL 1 DAY
                    THEN NULL
                    ELSE v_now
                END
            ELSE NULL
        END
    WHERE a.devotion_id = p_devotion_id
      AND a.user_id = p_user_id
      AND b.repetition_number = p_repetition_number;
END$$

DELIMITER ;

如果已有同名过程,需要先通过数据库管理工具替换原定义。DELIMITER 是 mysql 命令行等客户端使用的指令;通过应用驱动提交建过程语句时,通常只提交 CREATE PROCEDURE ... END。

调用方式不变:

CALL finish_repetition(8, 1, 1, 0);

示例中重复使用 start_time 计算条件,是为了避免依赖多表 UPDATE 中各项赋值的执行顺序。

日期和条件完成规则还要注意什么?

原代码中保存条件完成时间的局部变量声明为 DATE:

DECLARE conditionally_complete_time DATE;

这个类型只能保存日期,即使后面赋值为 NOW(),时分秒也会丢失。修改后的示例使用 DATETIME 变量,同时还需要检查表中的 end_time 和 conditionally_complete_time 是否支持保存完整时间。

判断时间是否属于当天,建议使用左闭右开区间:

start_time >= v_day_start
AND start_time < v_day_start + INTERVAL 1 DAY

这样可以覆盖当天带小数秒的时间,避免以 23:59:59 为上限时遗漏最后一秒内的小数秒值。“当天”按当前数据库会话的时间语义计算,应用与数据库应使用一致的时区约定。

文字描述与代码中的条件完成规则有差异。如果实际需求是只要 conditionally_complete = 1 就写入条件完成时间,不管是否当天完成,可以将对应赋值改成:

b.conditionally_complete_time = IF(
    p_conditionally_complete = 1,
    v_now,
    NULL
)

上述更新还沿用了原代码的行为:普通完成时会清空 conditionally_complete_time,条件完成时会清空 end_time。重复调用是否允许覆盖已有时间,需要按业务规则决定。start_time 为 NULL 时,示例也沿用原逻辑,将状态设为 2。

如何继续排查 Query interrupted?

先保留完整错误信息,包括错误码、SQLSTATE、执行耗时,以及通过哪个客户端或应用调用。仅凭 Query interrupted 这一描述,无法确定是查询逻辑、客户端取消还是服务端终止请求。

可以按以下顺序检查:

  1. 用相同参数执行只读查询,确认匹配记录的数量和 start_time。
  2. 如果过程长时间没有返回,在另一个连接中执行 SHOW FULL PROCESSLIST,观察是否等待锁或持续运行。查看其他连接的信息可能需要相应权限。
  3. 检查调用端是否设置了查询超时或取消操作,并核对数据库管理工具、连接代理及服务端是否发起过终止请求。
  4. 使用 SHOW INDEX 和 EXPLAIN 检查筛选、关联条件是否有合适索引。目前没有表结构和执行计划,不能直接断言缺少索引就是原因。

可以用以下查询确认数据范围:

SELECT r.devotion_id,
       r.user_id,
       r.repetition_number,
       r.start_time
FROM repetitions AS r
WHERE r.devotion_id = 8
  AND r.user_id = 1
  AND r.repetition_number = 1;

如果业务要求这些字段唯一标识一次执行,应检查是否存在重复记录,并考虑建立相应的唯一约束。关联更新不会像标量子查询那样因返回多行报错,但可能更新多条匹配记录,因此仍需确认数据唯一性。

备注:内容仅供参考。