PostgreSQL WAL归档异常：archive_command未执行

开发者阿泽

2026-7-28

PostgreSQL WAL归档无文件生成问题排查

问题场景

我的PostgreSQL配置如下：

wal_level = replica
archive_mode = on
archive_command = 'touch /var/backups/test'
archive_timeout = 1min

权限配置正常，Postgres用户可写入/var/backups/目录，且已重启数据库确保配置生效。执行SELECT pg_switch_wal()后，$PGDATA/pg_wal/下有数据，但/var/backups/中无内容，查看Docker日志也无错误或警告：

2023-03-13 07:29:36.216 UTC [108] STATEMENT:  insert into prueba2 values (165);
2023-03-13 07:33:43.197 UTC [51] LOG:  checkpoint starting: time
2023-03-13 07:33:43.418 UTC [51] LOG:  checkpoint complete: wrote 2 buffers (0.0%); 0 WAL file(s) added, 0 removed, 1 recycled; write=0.101 s, sync=0.025 s, total=0.221 s; sync files=2, longest=0.017 s, average=0.013 s; distance=6606 kB, estimate=6606 kB

可能的原因及排查方向

WAL段未满足归档条件：PostgreSQL仅归档已被检查点标记为不再需要的WAL段。执行pg_switch_wal()只是切换新WAL段，但旧段需等待checkpoint完成后才会进入归档队列。从日志可见最近的checkpoint显示0 WAL file(s) added，说明没有WAL段符合归档要求。
archive_timeout未触发：archive_timeout为1分钟，但仅当当前WAL段有写入活动且超时时才会自动切换并尝试归档。若切换后的旧段未被checkpoint处理，即使超时也不会触发归档。
Docker路径映射异常：如果是Docker部署，需确认容器内的/var/backups/是否正确映射到宿主机对应目录。可能你在宿主机查看的路径并非容器内部实际路径，导致误以为无文件生成。
归档命令静默失败：touch命令本身几乎不会返回错误（除非路径完全不存在），可修改归档命令为带日志输出的形式，比如：
```
archive_command = 'touch /var/backups/test_$(date +%s) || echo "归档失败于 $(date)" >> /var/log/postgres_archive.log'
```
以此确认命令是否实际执行，以及是否存在隐藏错误。
wal_level参数未生效：执行SHOW wal_level;确认实际生效的参数值，避免因多配置文件覆盖等问题导致配置未加载。