PostgreSQL错误码与严重级别映射查询及FATAL/PANIC错误处理咨询

错误码与严重级别的映射问题 #

• PostgreSQL官方文档明确了ERROR、FATAL、PANIC三个核心错误严重级别，同时提供了完整的SQLSTATE错误码列表，但不存在官方公开的错误码与严重级别一一映射关系。
• 这是因为错误码（SQLSTATE）的作用是分类错误类型（比如语法错误、权限不足、资源耗尽），而严重级别侧重的是错误对数据库会话或实例的影响程度，二者设计维度完全不同。
• 实际开发中，直接从驱动返回的错误对象里读取severity字段即可获取对应级别，没必要通过错误码反向推导。

客户端微服务收到FATAL/PANIC错误的处理建议 #

针对FATAL错误 #

• FATAL错误会直接终止当前数据库会话，常见场景包括连接权限失效、会话超时、违反强制约束导致会话被终止等。
• 收到这类错误时，不需要停止微服务运行，但必须立刻关闭当前失效的数据库连接，然后尝试重新建立新连接，恢复正常请求处理即可。
• 注意：如果频繁触发FATAL错误，一定要排查根源（比如数据库配置变更、账号权限过期、网络波动），避免反复重建连接造成资源浪费。

针对PANIC错误 #

• PANIC是最高级别的错误，通常意味着数据库实例出现严重故障（比如磁盘损坏、内存耗尽、核心进程崩溃），会直接导致数据库终止所有会话并停止自身进程。
• 收到PANIC错误时，建议触发服务优雅停止或降级流程：
  • 停止接收新请求，避免向上游返回大量无效错误响应；
  • 清理当前正在处理的请求资源（比如回滚未提交的事务）；
  • 等待数据库恢复或运维介入后，再重启微服务恢复正常服务。

内容的提问来源于stack exchange，提问作者Pitming Sir