Wal-G远程备份推送在PostgreSQL 15及以上版本中的问题解析

背景介绍

Wal-G是一个流行的PostgreSQL数据库备份工具，它支持多种存储后端（如S3、GCS等）来存储数据库备份。在PostgreSQL数据库管理领域，Wal-G因其高效性和可靠性而广受青睐。然而，随着PostgreSQL 15版本的发布，一些用户在使用Wal-G进行远程备份推送（backup-push）时遇到了问题。

问题现象

当用户尝试在PostgreSQL 15或16版本上使用wal-g backup-push命令进行远程备份（不指定数据目录参数）时，会遇到以下错误：

ERROR: ReadRequestBody: read upload data failed
caused by: CompressAndEncrypt: compression failed

值得注意的是，这个问题仅出现在PostgreSQL 15及以上版本中，而在PostgreSQL 14及以下版本中相同的命令可以正常工作。如果用户指定了数据目录参数（如wal-g backup-push $PGDATA），则备份在所有版本中都能正常工作。

根本原因分析

这个问题源于PostgreSQL 15版本中对BASE_BACKUP命令语法和基础备份协议的修改。PostgreSQL 15移除了对旧版BASE_BACKUP命令语法的支持，这影响了Wal-G与PostgreSQL服务器之间的通信协议。

通过分析日志可以发现关键差异：

在PostgreSQL 14中，备份数据流包含有效的tar头部信息：

[global/pg_control]
copied 512 backup_label0000600 0000201 0000211 ...

而在PostgreSQL 15中，数据流格式发生了变化：

[global/pg_control]
copied 11 nbase.tar

这种格式变化导致Wal-G无法正确解析备份数据流，最终引发压缩失败的错误。

解决方案

这个问题实际上已经在Wal-G的代码库中得到修复。修复方案涉及更新Wal-G以支持PostgreSQL 15及更高版本的新备份协议。具体来说，修复内容包括：

1. 更新BASE_BACKUP命令的处理逻辑以适应新协议
2. 确保数据流解析器能够正确处理新版数据格式
3. 保持与旧版本PostgreSQL的兼容性

最佳实践建议

对于需要使用Wal-G进行PostgreSQL备份的用户，建议：

1. 对于PostgreSQL 15及以上版本，确保使用最新版的Wal-G
2. 如果必须使用旧版Wal-G，可以考虑指定数据目录参数作为临时解决方案
3. 定期检查Wal-G的更新，确保与PostgreSQL新版本保持兼容
4. 在生产环境升级前，先在测试环境验证备份恢复流程

总结

PostgreSQL 15对备份协议的修改导致了Wal-G远程备份推送功能的问题。这个问题凸显了数据库工具与数据库引擎版本兼容性的重要性。通过使用最新版的Wal-G，用户可以无缝地在PostgreSQL 15及以上版本中使用远程备份功能。这也提醒我们，在进行数据库版本升级时，需要同时评估和更新相关的管理工具链。