// PostgreSQL 错误参考

PostgreSQL 25P03:事务内空闲会话超时

会话待在一个打开的事务里无所事事的时间超过了 idle_in_transaction_session_timeout,于是服务器把它关掉了。

SQLSTATE
25P03
名称
idle_in_transaction_session_timeout
类别
无效的事务状态
错误信息
terminating connection due to idle-in-transaction timeout

它的意思

一个已经启动了事务然后变得安静的会话是 idle in transaction。它仍然握着锁,并阻止旧行版本被清理。 idle_in_transaction_session_timeout 会让服务器在超过时限后结束这类会话;触发时客户端会收到这个 FATAL 错误,随后连接被关闭,事务回滚。

最常见的根因是应用程序代码开启了事务,然后在提交之前又在等待别的事情,比如网络调用或用户输入。

常见原因

  • 会把执行慢操作(HTTP 调用、文件处理)的代码放在 BEGIN 和 COMMIT.
  • 一个客户端或 GUI 在自动提交关闭的情况下,在之后仍然保持打开状态 SELECT,因此事务会保持打开状态。
  • 一条从不提交也不回滚的异常路径,让连接池里的连接闲置在事务中。

如何修复它

  1. 查找在事务中空闲的会话以及它们空闲了多长时间。

    SELECT pid, usename, application_name, now() - state_change AS idle_for, query
    FROM pg_stat_activity
    WHERE state = 'idle in transaction'
    ORDER BY idle_for DESC;
  2. 耗时的非数据库工作请放在开启事务之前或提交之后再做,而提交或回滚操作要始终放在 finally 块。

  3. 把超时当作安全网保留;如果某些作业确实需要更久,可按角色或数据库单独设置。

    ALTER ROLE app SET idle_in_transaction_session_timeout = '5min';

相关错误

更多无效事务状态错误

代码和消息文本来自 PostgreSQL 文档,附录 A:PostgreSQL 错误代码。浏览完整的 PostgreSQL 错误列表 或者 搜索每个数据库错误.

// 错误更少,修复更快

在 SQLly 中使用 PostgreSQL

适用于 macOS、Windows 和 Linux 的原生 SQL 客户端,智能感知能理解你的数据库模式,高危语句有防护,错误信息清晰,支持 PostgreSQL 以及你使用的其他数据库。