PostgreSQL报25P02:先找最早失败的SQL

一条写入失败后,连后续普通查询也开始报25P02,先别急着修改每条查询。这个SQLSTATE对应in_failed_sql_transaction:当前连接的事务已进入失败状态,后续命令被拒绝;真正触发失败的语句通常在前面。

本文适用于PostgreSQL 16—18。SQL在数据库客户端执行,反斜杠命令仅用于psql。先保存原始错误和请求上下文,再决定如何结束失败事务;不要在正式业务上重跑整段脚本来寻找错误。

沿着同一连接,往前找到第一条错误

把应用日志按请求、连接和时间串起来。最早可能是23505唯一约束冲突、23503外键冲突、42P01对象不存在,或者权限、类型、超时问题。程序捕获异常后仍继续查询,就可能用一串25P02盖住首错。连接池里多个请求同时报错时,不能只按相邻日志行认定它们来自同一个事务。

在发生错误的psql窗口,可以查看最近一次服务端错误的详细信息:

\errverbose

这条客户端命令不会重新执行业务SQL,但它只重复最近错误。若最近一次已经是25P02,就需要向前查终端输出、应用异常链和已记录的数据库日志;它不能替你找回更早的错误。记录首错的SQLSTATE、实际参数、约束或对象名,日志中有敏感数据时先脱敏。

若首错明确是表不存在,按PostgreSQL对象名与schema排查核对实际连接及名称。修正后仍要处理原来的失败事务,只修SQL文本不会自动让该事务恢复。

用管理连接观察状态,不在里面替别人回滚

下面在另一个正常、具有相应诊断权限的连接里执行,只读取状态。12345要替换为从应用连接日志或驱动信息核实的数据库后端PID,不是网站进程号,也不能随便选择一条看起来空闲的连接:

SELECT pid, usename, datname, application_name,
       state, xact_start, query_start, state_change,
       left(query, 200) AS recent_query
FROM pg_stat_activity
WHERE pid=12345;

idle in transaction (aborted)表示这个后端正在失败事务中等待客户端下一条命令。query只显示当前或最近执行的语句,可能已经是被拒绝的查询,不是完整历史。结果为空也可能是连接已结束;信息缺失时先核对可见权限和活动采集,不给业务账号临时加超级用户权限。

管理连接用于观察。对应用连接执行回滚,必须由持有那条连接的程序处理;在管理窗口执行ROLLBACK,只作用于管理窗口自己的事务。重启整个数据库也不能修正原来的错误输入和异常处理逻辑。

回滚会撤销这个事务的未提交工作

如果故障发生在你自己控制的交互会话,已确认要放弃该事务、并记录了首错,回到原报错连接执行:

ROLLBACK;
SELECT 1 AS connection_usable;

ROLLBACK会结束当前事务并撤销其中尚未提交的表数据变更,包括出错之前已执行的那些步骤。它不是只清除最后一条报错。已经提交的其他事务,以及已经发出的邮件、支付等外部动作,不会跟着撤销。SELECT 1成功只证明该连接能够继续查询,不能证明原业务已经完成。

如果连接由应用或ORM持有,应通过该框架的事务回滚和会话清理接口收尾,再按连接池规则归还连接。捕获异常不等于事务已结束;把失败连接直接交给下一次请求,可能让下一次请求一开始就报25P02。不要另建一条连接执行ROLLBACK后,就认为原连接已处理。

局部恢复需要预先设计保存点。只有故障之前已经建立、仍然有效的保存点,才能作为ROLLBACK TO SAVEPOINT的目标;回退会丢弃该点之后的工作。收到25P02后临时补建保存点,不能挽救前面的执行结果。整项业务要求一起成功时,应按完整事务回滚。

修复首错,再按真实事务范围验收

确认BEGIN到COMMIT之间包含哪些操作,也检查驱动是否自动开启事务。即使代码里没有手写BEGIN,客户端库仍可能形成事务块。重试应从已经明确的业务边界开始,不能只重放最后一条失败SQL,更不能把已发送的外部操作无条件重复一遍。

在隔离环境检查已审查的psql脚本时,可以在执行前启用遇错停止:

\set ON_ERROR_STOP on

它让psql在错误处停止后续处理,便于保留首错;不等于撤销此前已提交的语句。恢复任务应继续使用PostgreSQL隔离恢复验证,核对失败前已经留下哪些对象和数据,不在正式库覆盖重试。

最后通过隔离应用触发一次可控的输入错误:确认首错被记录、失败事务正常结束、数据没有留下半套业务状态;再用同一连接池提交正常请求,确认不会继承25P02。正式修复后同时观察首错和后续错误是否收敛,不能只看错误页面暂时消失。