Patroni项目中混合版本集群的WAL文件堆积问题分析

问题现象

在Patroni管理的PostgreSQL高可用集群中，当主节点和备节点运行不同版本的Patroni时，可能会出现备节点WAL文件不断堆积的问题。具体表现为备节点的pg_wal目录持续增长，最终导致磁盘空间耗尽。

问题根源

通过分析案例发现，该集群中存在以下版本差异：

• 主节点运行Patroni 3.2.1 + PostgreSQL 16.1
• 备节点运行Patroni 4.0.2 + PostgreSQL 16.4

这种混合版本环境下，新版本Patroni在备节点上创建了一个未使用的复制槽(pgsql_staging_01_vdl_intra)，而旧版本主节点并未正确识别和处理这个复制槽，导致备节点持续保留WAL文件而无法清理。

技术原理

PostgreSQL的复制槽机制用于确保主节点不会删除备节点尚未接收的WAL文件。正常情况下：

1. 主节点上的复制槽会跟踪备节点的复制进度
2. 备节点通过流复制持续获取WAL数据
3. 主节点根据复制槽状态清理已复制的WAL文件

在混合版本环境中，新版本Patroni的复制槽管理逻辑与旧版本存在兼容性问题，导致备节点上的复制槽无法被正确识别和使用，从而造成WAL文件堆积。

解决方案

对于已经出现此问题的环境，可以采取以下措施：

1. 统一升级方案：将主节点Patroni升级到4.0.2版本

   • 进入维护模式(patronictl pause)
   • 升级Patroni服务
   • 退出维护模式(patronictl resume)
   • 此操作不会重启PostgreSQL服务

2. 临时降级方案：将备节点Patroni降级到3.2.1版本

   • 确保版本与主节点一致
   • 需要重启Patroni服务

3. 等待修复版本：Patroni 4.0.3版本将解决此兼容性问题

   • 发布后可选择升级备节点

最佳实践建议

1. 版本一致性：确保集群中所有节点运行相同版本的Patroni
2. 升级策略：采用滚动升级时，应尽快完成所有节点的升级
3. 监控机制：设置对pg_wal目录大小的监控告警
4. 定期检查：定期验证复制槽状态和WAL文件清理情况

总结

Patroni作为PostgreSQL的高可用管理工具，在版本升级过程中需要特别注意集群的一致性。混合版本环境可能导致各种兼容性问题，WAL文件堆积只是其中之一。运维团队应当建立完善的升级流程和监控机制，确保集群的健康运行。对于已经出现的问题，可根据实际情况选择升级、降级或等待修复版本的解决方案。