// PostgreSQL 错误参考
PostgreSQL 25P03:事务内空闲会话超时
会话待在一个打开的事务里无所事事的时间超过了 idle_in_transaction_session_timeout,于是服务器把它关掉了。
- SQLSTATE
25P03- 名称
idle_in_transaction_session_timeout- 类别
- 无效的事务状态
它的意思
一个已经启动了事务然后变得安静的会话是 idle in transaction。它仍然握着锁,并阻止旧行版本被清理。 idle_in_transaction_session_timeout 会让服务器在超过时限后结束这类会话;触发时客户端会收到这个 FATAL 错误,随后连接被关闭,事务回滚。
最常见的根因是应用程序代码开启了事务,然后在提交之前又在等待别的事情,比如网络调用或用户输入。
常见原因
- 会把执行慢操作(HTTP 调用、文件处理)的代码放在
BEGIN和COMMIT. - 一个客户端或 GUI 在自动提交关闭的情况下,在之后仍然保持打开状态
SELECT,因此事务会保持打开状态。 - 一条从不提交也不回滚的异常路径,让连接池里的连接闲置在事务中。
如何修复它
-
查找在事务中空闲的会话以及它们空闲了多长时间。
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;
-
耗时的非数据库工作请放在开启事务之前或提交之后再做,而提交或回滚操作要始终放在
finally块。 -
把超时当作安全网保留;如果某些作业确实需要更久,可按角色或数据库单独设置。
ALTER ROLE app SET idle_in_transaction_session_timeout = '5min';
相关错误
更多无效事务状态错误
代码和消息文本来自 PostgreSQL 文档,附录 A:PostgreSQL 错误代码。浏览完整的 PostgreSQL 错误列表 或者 搜索每个数据库错误.
// 错误更少,修复更快
在 SQLly 中使用 PostgreSQL
适用于 macOS、Windows 和 Linux 的原生 SQL 客户端,智能感知能理解你的数据库模式,高危语句有防护,错误信息清晰,支持 PostgreSQL 以及你使用的其他数据库。