Barman Cloud与Minio S3集成时对象删除问题的技术解析

问题背景

在使用Barman Cloud与CloudNativePG(CNPG)结合进行PostgreSQL数据库备份时，用户遇到了一个关于对象删除的特定问题。当配置了备份保留策略后，Barman无法从Minio S3存储中删除过期的备份对象，导致存储空间不断增长。

问题现象

从日志中可以看到，Barman在执行删除操作时返回了错误信息："Object name contains unsupported characters"。这个错误发生在尝试列出对象(ListObjectsV2)时，表明Minio认为对象名称包含不支持的字符。

技术分析

经过深入调查，发现问题根源在于备份目标路径(destinationPath)的配置格式。在Minio S3环境下，路径配置存在一个关键细节差异：

• 错误配置：路径以斜杠结尾(s3://bucket/path/)
• 正确配置：路径不应以斜杠结尾(s3://bucket/path)

这个看似微小的差别在Minio实现中会导致对象名称解析异常。Minio的S3兼容API对路径格式更为严格，当路径以斜杠结尾时，它会错误地将后续操作中的对象名称解析为包含非法字符。

解决方案

要解决这个问题，只需在CloudNativePG的备份配置中确保destinationPath不以斜杠结尾：

backup:
  barmanObjectStore:
    destinationPath: "s3://cybroslabs-backups/databases/converge43_v1"  # 正确配置

技术建议

1. 版本兼容性：虽然此问题在Barman Cloud 3.7.0及以上版本中可能已修复，但仍建议保持配置的规范性。

2. 测试验证：在配置备份系统后，应手动测试删除功能以确保其正常工作。

3. 监控机制：设置存储使用量监控，及时发现因删除失败导致的存储增长问题。

4. 文档审查：虽然某些文档示例可能展示带斜杠的路径，但在实际生产环境中应避免这种配置。

总结

这个案例展示了在集成不同技术栈时，细微的配置差异可能导致功能异常。特别是在使用开源组件时，理解底层实现细节对于问题排查至关重要。对于使用Barman Cloud与Minio S3集成的用户，确保备份路径格式正确是保证备份清理功能正常工作的关键。