ReportPortal在Kubernetes环境中修改Launch报错问题分析与解决方案

问题现象

在Kubernetes集群中使用Helm部署ReportPortal时，用户遇到了一个特定问题：当尝试通过UI界面修改（停止/修改/删除）Launch时，系统返回500错误，错误信息显示"Could not create URI object: Expected scheme-specific part at index 6: https:"。该问题在ReportPortal最新版本25.1中出现，但在demo环境和本地docker部署中无法复现，仅出现在云端的Kubernetes环境中。

错误分析

从日志中可以观察到，核心错误是URI对象创建失败，具体表现为URI语法异常。错误发生在API服务处理请求时，系统无法正确解析https协议相关的URI部分。这种错误通常与以下方面相关：

1. 网络配置问题：特别是Ingress控制器的配置，可能影响了URI的生成和解析
2. 环境变量设置：某些关键环境变量可能未正确配置
3. 服务间通信：API服务与其他服务间的通信协议配置不一致

根本原因

经过社区讨论和技术分析，确定该问题与Kubernetes集群中使用的Ingress控制器类型直接相关。具体表现为：

• 使用非Nginx Ingress控制器（如GKE Gateway或AWS ALB）时会出现此问题
• 切换到Nginx Ingress控制器后问题得到解决

这表明ReportPortal在生成内部服务URI时，对Ingress控制器的类型有一定依赖性，特别是在处理HTTPS协议和路径重写方面。

解决方案

推荐方案：使用Nginx Ingress控制器

1. 在Kubernetes集群中部署Nginx Ingress控制器
2. 更新ReportPortal的Ingress配置，指定使用Nginx控制器
3. 确保Ingress配置中包含正确的TLS/SSL设置

替代方案：调整现有Ingress配置

如果必须使用其他Ingress控制器（如AWS ALB），可以尝试以下调整：

1. 检查并确保所有服务端点配置正确
2. 验证HTTPS相关配置是否完整
3. 检查服务间的通信协议是否一致

配置建议

对于使用Helm部署的情况，建议检查并确保以下配置项正确：

1. Ingress类明确指定为nginx
2. TLS/SSL配置完整且正确
3. 服务端点配置包含完整协议和端口信息

总结

ReportPortal在Kubernetes环境中的部署对Ingress控制器有一定要求，特别是在处理HTTPS协议和内部服务通信时。使用Nginx Ingress控制器是最稳定可靠的解决方案，能够避免此类URI解析问题。对于必须使用其他Ingress控制器的情况，需要仔细检查网络配置和服务端点设置，确保所有协议相关配置完整且一致。

这个问题也提醒我们，在云原生环境中部署复杂应用时，网络组件的选择和配置对应用功能的完整性有着重要影响，需要在部署前充分了解和验证各组件的兼容性。