ReportPortal与PostgreSQL RDS 16.x版本的兼容性问题解决方案

问题背景

在使用ReportPortal 5.11.1版本（Helm Chart 24.1.1）部署时，用户发现与AWS RDS PostgreSQL 16.2版本存在兼容性问题。具体表现为数据库迁移任务无法正常执行，导致后续服务启动时出现"relation不存在"的错误。

问题现象

1. 迁移作业能够成功连接到RDS实例，但随后停滞不前
2. 最终出现错误提示："no pg_hba.conf entry for host"
3. 数据库保持为空状态，没有执行任何迁移操作
4. 服务组件启动后因缺少必要表结构而报错

根本原因分析

经过技术团队调查，发现问题的核心在于PostgreSQL 16.x版本默认强制SSL连接的安全策略。具体表现为：

1. RDS 16.x默认启用了rds.force_ssl=1参数
2. ReportPortal的迁移组件未配置SSL连接参数
3. 由于安全策略限制，非加密连接被拒绝

解决方案

推荐解决方案

1. 修改RDS参数组中的rds.force_ssl参数，将其设置为0
2. 重启RDS实例使参数生效
3. 重新部署ReportPortal

替代方案（更安全）

1. 配置ReportPortal使用SSL连接PostgreSQL
2. 在values.yaml中增加SSL相关配置：

   postgresql:
     ssl: true
     sslMode: require
   

3. 确保RDS实例已配置正确的SSL证书

版本兼容性说明

经测试验证：

• RDS PostgreSQL 13.15版本工作正常
• RDS PostgreSQL 16.2/16.3版本需要上述调整
• 其他中间版本可能存在类似问题

最佳实践建议

1. 生产环境建议采用SSL连接方案
2. 升级前应在测试环境验证兼容性
3. 关注ReportPortal官方更新，未来版本可能会原生支持PostgreSQL 16.x的SSL连接

技术细节

PostgreSQL 16.x在安全方面有显著增强，特别是：

• 默认加密策略更严格
• 认证机制有所调整
• 连接协议有优化

这些变化虽然提升了安全性，但也可能导致旧版客户端出现连接问题。理解这些底层变化有助于更好地解决类似兼容性问题。

总结

ReportPortal作为流行的测试报告平台，与新版数据库的集成需要特别注意安全策略的匹配。通过合理配置SSL参数或调整数据库安全设置，可以确保系统在PostgreSQL 16.x环境下稳定运行。建议用户在升级数据库版本前，充分测试并参考官方文档获取最新兼容性信息。