CloudNativePG 备份失败问题：S3校验和类型不匹配的解决方案

问题背景

在使用CloudNativePG进行PostgreSQL数据库备份时，部分用户遇到了备份失败的情况，错误信息显示"S3校验和类型不匹配"。这一问题主要出现在使用非AWS S3兼容存储服务（如PureStorage S3、Hetzner对象存储等）的环境中。

技术分析

该问题的根源在于Barman工具的最新版本（3.14.0及以上）使用了更新版的boto3库（1.36.0及以上），这些版本改变了S3完整性校验的默认行为。具体表现为：

1. boto3从1.36.0版本开始引入了更严格的校验和验证机制
2. 部分S3兼容存储服务尚未完全支持新的校验和协议
3. 这种不兼容性导致在上传备份分片时出现"Checksum Type mismatch"错误

影响范围

此问题影响以下组件：

• 包含Barman 3.14.0及以上版本的所有系统容器镜像
• 使用Barman 3.14.0及以上版本的plugin-barman-cloud插件（从0.5.0版本开始）

解决方案

对于直接使用CloudNativePG集群的情况

在集群的spec配置中添加以下环境变量：

spec:
  env:
    - name: AWS_REQUEST_CHECKSUM_CALCULATION
      value: when_required
    - name: AWS_RESPONSE_CHECKSUM_VALIDATION
      value: when_required

对于使用plugin-barman-cloud插件的情况

在ObjectStore对象的配置中添加以下环境变量：

spec:
  instanceSidecarConfiguration:
    env:
      - name: AWS_REQUEST_CHECKSUM_CALCULATION
        value: when_required
      - name: AWS_RESPONSE_CHECKSUM_VALIDATION
        value: when_required

技术原理

这两个环境变量的作用分别是：

• AWS_REQUEST_CHECKSUM_CALCULATION=when_required：仅在必要时计算请求校验和
• AWS_RESPONSE_CHECKSUM_VALIDATION=when_required：仅在必要时验证响应校验和

通过这样的配置，可以恢复到与旧版boto3类似的校验和行为，从而避免与不完全支持新校验和协议的S3兼容存储服务产生冲突。

最佳实践建议

1. 对于生产环境，建议先在小规模测试环境中验证此解决方案的有效性
2. 长期来看，建议联系您的S3存储服务提供商，确认其对最新S3协议的支持计划
3. 定期检查CloudNativePG的更新日志，关注此问题的官方修复进展

总结

CloudNativePG用户在使用非AWS S3兼容存储服务时可能会遇到备份失败的问题，通过合理配置校验和相关环境变量可以有效解决。这一方案既保证了数据备份的可靠性，又兼容了各类S3兼容存储服务，是当前环境下的最佳实践。