// PostgreSQL 错误参考

PostgreSQL 53200:内存不足

服务器进程无法为查询分配内存。通常是排序或哈希操作过大、在内存中构建的结果集太大,或繁忙的连接太多。

SQLSTATE
53200
名称
out_of_memory
类别
资源不足
错误信息
out of memory
DETAIL:  Failed on request of size 1048576 in memory context "ExecutorState".

它的意思

PostgreSQL 在上下文中分配内存。当操作系统拒绝分配时,语句会以 53200 失败并显示 DETAIL 行会列出请求大小和内存上下文。服务器日志里还会附上一份各内存上下文大小的转储,显示内存都花在哪儿了。

在使用内存过量分配的 Linux 上,内核的 OOM killer 可能会直接杀掉 PostgreSQL 进程;之后服务器会重启所有会话,客户端会看到连接断开。

常见原因

  • work_mem 设得很高,再乘以大量排序和哈希节点,而且同时发生在多个会话中。
  • 把海量数据聚合为单个值返回的查询,例如 array_agg 或者 string_agg 超过数百万行。
  • 连接数超出了本机内存的承受能力。
  • 扩展中的内存泄漏,或非常大的 maintenance_work_mem 在索引构建期间。

如何修复它

  1. 读取服务器日志中的内存上下文转储,以查看哪个上下文增长了。

  2. 降低 work_mem 在全局设置,只为需要它的会话调高。

    ALTER SYSTEM SET work_mem = '16MB';
    SELECT pg_reload_conf();
    -- for one heavy report:
    SET work_mem = '256MB';
  3. 检查哈希连接和排序计划是否处理的行数远超预期,并修正估算或添加索引。

    EXPLAIN (ANALYZE, BUFFERS) SELECT ...;
  4. 用连接池工具限制并发数,并在 Linux 上设置 vm.overcommit_memory = 2 这样内存分配会干脆地失败,而不是触发 OOM killer。

相关错误

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

// 错误更少,修复更快

在 SQLly 中使用 PostgreSQL

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