// PostgreSQL 错误参考

PostgreSQL 57P01:连接因管理员操作被终止

服务器结束了此会话:管理员调用了 pg_terminate_backend,或服务器正在关闭。请重新连接并重试。

SQLSTATE
57P01
名称
admin_shutdown
类别
操作员干预
错误信息
terminating connection due to administrator command

它的意思

57P01(admin_shutdown)会作为一个 FATAL 错误,紧接着服务器就会关闭连接。当有人运行 pg_terminate_backend() 在会话上、服务器以快速关闭方式停止时,或托管服务重启或对实例做故障转移时。

会话中正在进行的事务都会被回滚。客户端下次使用该连接时会失败,因此连接池应当丢弃它并重新建立一个。

常见原因

  • 管理员或脚本运行了 pg_terminate_backend(pid),例如清理空闲会话或锁。
  • 服务器正在关闭或重启(pg_ctl stop -m fast、维护、升级)。
  • 托管的 PostgreSQL 服务发生故障转移或进行了维护。

如何修复它

  1. 重新连接;如果之前的操作是在事务中完成的,请重新执行整个事务。

  2. 发生此错误后,请配置连接池测试连接,或在新连接上重试一次。

  3. 如果会话意外终止,请检查服务器日志以及任何调用 pg_terminate_backend.

    SELECT pid, usename, query FROM pg_stat_activity WHERE query ILIKE '%pg_terminate_backend%';

相关错误

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

// 错误更少,修复更快

在 SQLly 中使用 PostgreSQL

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