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,再把业务专属例外加入同一处策略。
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)预期输出:
40001 retry_whole_transaction
40P01 retry_whole_transaction
55P03 retry_if_policy_allows
23505 fail_immediately
08006 reconcile_before_retry23505 并非永远不能重试,但它通常表示业务唯一性冲突。若请求本来就是幂等写入,更合适的做法往往是 INSERT ... ON CONFLICT、读取现有结果或返回冲突,而不是把完全相同的事务无限重放。
只重试整个事务
遇到 40001 或 40P01 后,当前事务已经不能继续正常执行。正确动作是回滚,重新开始一个新事务,并重新执行事务中的读取、判断和写入;只重试最后一条 SQL 可能使用已经过期的业务判断。
在 SERIALIZABLE 隔离级别下,40001 表示 PostgreSQL 为了维持可串行化结果主动中止了一个事务。死锁则由多个事务形成锁等待环,数据库选择其中一个作为受害者并返回 40P01。两者共同点都是:并发关系可能在下一次尝试时改变,所以“整个事务重新运行”有机会成功。
设置重试边界
可重试不等于无限重试。通常应设置最大尝试次数,并在每次失败后加入随机抖动的退避时间,避免大量事务在相同时间再次撞上同一热点。重试预算还应受请求总超时约束,否则数据库已经恢复,调用方却早已放弃请求。
55P03 更适合按业务策略处理。例如应用显式使用 FOR UPDATE NOWAIT 来实现“抢不到就稍后再试”,可以做短暂有界重试;如果锁竞争代表用户正在编辑同一对象,也可以立即返回冲突。是否重试由锁策略决定,而不是仅由错误码决定。
排查不该盲目重试的错误
语法错误、列不存在、权限不足、违反外键或数据格式错误,在输入和代码不变时重复执行不会自行恢复。对这些错误继续重试只会放大数据库压力,并把真正的问题延迟暴露。若看到 25P02,它通常只是“本事务先前已失败”的后续症状,应先回滚并定位同一事务里更早出现的原始错误码。
连接异常还要单独看待:连接在 COMMIT 附近断开时,客户端可能不知道事务究竟提交成功还是失败。此时直接重放一个非幂等事务,可能制造重复订单或重复扣款。应用需要用业务幂等键、可查询的请求记录或对账流程先确认结果,再决定是否补做。
因此,可靠的重试判断不是“哪些错误看起来临时”,而是三个连续问题:数据库是否明确要求重跑事务、事务结果是否确定、业务操作是否允许重复执行。只有这三点同时得到控制,重试才是恢复机制,而不是新的并发故障来源。