// PostgreSQL 错误参考

PostgreSQL 53100:磁盘已满

存放数据目录、WAL 或临时文件的文件系统已满。在腾出空间之前写入都会失败;WAL 磁盘写满可能导致服务器停机。

SQLSTATE
53100
名称
disk_full
类别
资源不足
错误信息
could not extend file "base/16384/16397": No space left on device
HINT:  Check free disk space.

它的意思

PostgreSQL 收到了 No space left on device 来自操作系统,发生在扩大表或索引文件、写临时排序文件或写 WAL 的时候。该语句会失败并报 53100(disk_full)并且其事务已回滚。

如果 WAL 目录(pg_wal)被填满时,服务器无法再写入任何更改,会以 PANIC 状态关闭;在空间被释放之前它不会再次启动。千万不要从 pg_wal 手动完成。

常见原因

  • 数据增长,或者由于大量更新和删除而没有足够清理导致的表和索引膨胀。
  • WAL 因复制槽处于非活动状态而堆积、归档(archive_command)失败,或者 max_wal_size / wal_keep_size 很大。
  • 大规模的排序、哈希或 CREATE INDEX 正在写入临时文件。
  • 服务器日志或同一卷上的其他文件。

如何修复它

  1. 找出是什么在占用空间。

    SELECT pg_size_pretty(pg_database_size(current_database()));
    SELECT relname, pg_size_pretty(pg_total_relation_size(oid)) AS size
    FROM pg_class WHERE relkind = 'r'
    ORDER BY pg_total_relation_size(oid) DESC LIMIT 10;
  2. 查找阻碍 WAL 推进的复制槽,并把不再使用的删掉。

    SELECT slot_name, active, pg_size_pretty(pg_wal_lsn_diff(pg_current_wal_lsn(), restart_lsn)) AS retained
    FROM pg_replication_slots;
    SELECT pg_drop_replication_slot('old_slot');
  3. 检查 WAL 归档是否成功。

    SELECT archived_count, failed_count, last_failed_wal, last_failed_time FROM pg_stat_archiver;
  4. 释放或增加磁盘空间:扩展卷、删除无关文件,或使用 VACUUM FULL (需要腾出能容纳整张表完整副本的空间)或 pg_repack.

  5. 限制每个会话的临时文件使用,以免单个查询填满磁盘。

    ALTER SYSTEM SET temp_file_limit = '20GB';
    SELECT pg_reload_conf();

相关错误

更多资源不足错误

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

// 错误更少,修复更快

在 SQLly 中使用 PostgreSQL

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