pgBackRest备份至Google Cloud Storage时的速率限制问题分析与解决方案

问题背景

在使用pgBackRest 2.52版本将PostgreSQL 15.7数据库备份至Google Cloud Storage(GCS)时，部分用户遇到了"rateLimitExceeded"错误。该错误通常发生在增量备份过程中，特别是当系统尝试上传backup.manifest.copy文件时，GCS返回HTTP 429(Too Many Requests)状态码。

错误现象

错误日志显示，GCS对对象变异操作(创建、更新和删除)实施了速率限制。典型的错误信息如下：

HTTP request failed with 429 (Too Many Requests)
The object exceeded the rate limit for object mutation operations

根本原因分析

pgBackRest在备份过程中会定期保存备份清单(manifest)文件到存储库，这是为了支持备份恢复(resume)功能。对于大型数据库(如1TB以上)，即使设置1%的保存阈值也会产生约10GB的保存间隔，这在某些情况下可能触发GCS的速率限制。

解决方案

方案一：禁用恢复功能

如果不需要备份恢复功能，可以在配置文件中设置：

resume=n

这将完全禁用备份清单的定期保存，从根本上避免触发GCS的速率限制。

方案二：调整保存阈值

对于需要保留恢复功能的场景，可以增大manifest保存的阈值：

manifest-save-threshold=50GB

或

manifest-save-threshold=100GB

这样会减少保存操作的频率，降低触发GCS速率限制的风险。阈值设置应根据数据库大小和恢复容忍度来决定。

实施建议

1. 对于生产环境的大型数据库，建议先评估是否需要备份恢复功能
2. 如果不需要恢复功能，直接设置resume=n是最简单的解决方案
3. 如需保留恢复功能，应从较大阈值(如50GB)开始测试，逐步调整至最佳值
4. 监控备份日志，观察是否仍有速率限制错误出现

补充说明

值得注意的是，此问题并非在所有大型数据库上都稳定复现，可能与GCS服务的内部负载均衡机制有关。某些用户报告该问题会自行消失，但为保障备份稳定性，仍建议采取上述预防措施。