PostgreSQL / 系统课时

识别需要重试的数据库错误

识别需要重试的数据库错误

事务重试不能用“报错了就再执行一次”来实现。真正需要先判断的是:这个错误是否由并发竞争导致、当前事务是否已经失效,以及重复执行会不会产生新的副作用。本课以 PostgreSQL 的 SQLSTATE 为依据,建立可安全重试、立即失败和需要确认提交结果三类决策。

学习目标

  • 识别 40001(serialization_failure)和 40P01(deadlock_detected)这两类应重试整个事务的错误。
  • 用 SQLSTATE 而不是错误文案做程序化分类。
  • 区分确定失败、条件重试和提交结果未知,避免把重试变成重复写入。

先按 SQLSTATE 做决策

PostgreSQL 错误都带有五字符 SQLSTATE。应用应读取驱动暴露的错误码,而不是匹配英文错误消息,因为消息文本可能随版本、语言或上下文变化。

SQLSTATE 常见名称或类别 默认处理
40001 serialization_failure 重试整个事务
40P01 deadlock_detected 重试整个事务
55P03 lock_not_available 仅在主动使用 NOWAIT 等策略时做有界条件重试
23505 unique_violation 通常按业务冲突处理,不盲目重试
22xxx、多数 23xxx、42xxx 数据、约束、语法或对象错误 立即失败并修正输入或代码
25P02 in_failed_sql_transaction 次生错误;回滚并查找更早的根因
08xxx connection exception 先判断提交结果是否未知,再决定补偿或幂等重放

下面的最小分类器可以直接运行,用于展示决策边界。真实项目中应从数据库驱动异常对象读取 sqlstate,再把业务专属例外加入同一处策略。

python
from enum import Enum

class Action(str, Enum):
    RETRY_TX = "retry_whole_transaction"
    CONDITIONAL = "retry_if_policy_allows"
    FAIL = "fail_immediately"
    UNKNOWN_OUTCOME = "reconcile_before_retry"

def classify(sqlstate: str) -> Action:
    if sqlstate in {"40001", "40P01"}:
        return Action.RETRY_TX
    if sqlstate == "55P03":
        return Action.CONDITIONAL
    if sqlstate.startswith("08"):
        return Action.UNKNOWN_OUTCOME
    return Action.FAIL

for code in ["40001", "40P01", "55P03", "23505", "08006"]:
    print(code, classify(code).value)

预期输出:

text
40001 retry_whole_transaction
40P01 retry_whole_transaction
55P03 retry_if_policy_allows
23505 fail_immediately
08006 reconcile_before_retry

23505 并非永远不能重试,但它通常表示业务唯一性冲突。若请求本来就是幂等写入,更合适的做法往往是 INSERT ... ON CONFLICT、读取现有结果或返回冲突,而不是把完全相同的事务无限重放。

只重试整个事务

遇到 40001 或 40P01 后,当前事务已经不能继续正常执行。正确动作是回滚,重新开始一个新事务,并重新执行事务中的读取、判断和写入;只重试最后一条 SQL 可能使用已经过期的业务判断。

在 SERIALIZABLE 隔离级别下,40001 表示 PostgreSQL 为了维持可串行化结果主动中止了一个事务。死锁则由多个事务形成锁等待环,数据库选择其中一个作为受害者并返回 40P01。两者共同点都是:并发关系可能在下一次尝试时改变,所以“整个事务重新运行”有机会成功。

设置重试边界

可重试不等于无限重试。通常应设置最大尝试次数,并在每次失败后加入随机抖动的退避时间,避免大量事务在相同时间再次撞上同一热点。重试预算还应受请求总超时约束,否则数据库已经恢复,调用方却早已放弃请求。

55P03 更适合按业务策略处理。例如应用显式使用 FOR UPDATE NOWAIT 来实现“抢不到就稍后再试”,可以做短暂有界重试;如果锁竞争代表用户正在编辑同一对象,也可以立即返回冲突。是否重试由锁策略决定,而不是仅由错误码决定。

排查不该盲目重试的错误

语法错误、列不存在、权限不足、违反外键或数据格式错误,在输入和代码不变时重复执行不会自行恢复。对这些错误继续重试只会放大数据库压力,并把真正的问题延迟暴露。若看到 25P02,它通常只是“本事务先前已失败”的后续症状,应先回滚并定位同一事务里更早出现的原始错误码。

连接异常还要单独看待:连接在 COMMIT 附近断开时,客户端可能不知道事务究竟提交成功还是失败。此时直接重放一个非幂等事务,可能制造重复订单或重复扣款。应用需要用业务幂等键、可查询的请求记录或对账流程先确认结果,再决定是否补做。

因此,可靠的重试判断不是“哪些错误看起来临时”,而是三个连续问题:数据库是否明确要求重跑事务、事务结果是否确定、业务操作是否允许重复执行。只有这三点同时得到控制,重试才是恢复机制,而不是新的并发故障来源。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

识别需要重试的数据库错误

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通