ReportPortal项目中的Launch Controller API合并功能深度解析

在ReportPortal测试报告平台的使用过程中，Launch Controller API的合并功能是一个强大但文档相对简略的特性。本文将从技术实现角度深入剖析该API的核心参数和使用场景，帮助开发者更好地实现自动化测试报告的聚合管理。

合并功能的核心参数解析

Launch Controller API的合并请求体包含多个关键参数，其中最容易产生误解的是launches字段。这个字段实际上需要传入的是待合并的launch ID数组，而非合并数量。例如：

{
  "launches": [35932, 35934, 30585],
  "attributes": [
    {"key": "build_number", "value": "123"},
    {"key": "platform", "value": "Android"}
  ]
}

属性过滤的两种实现方式

1. 预查询合并模式

对于自动化流水线场景，推荐先通过API查询符合条件的launch列表：

GET /{projectName}/launch?filter.has.compositeAttribute=build_number:123,platform:Android

此查询会返回所有具有指定属性键值对的launch记录，获取ID列表后即可进行合并操作。

2. 直接合并模式

当已明确知道需要合并的具体launch ID时，可以直接构造合并请求。此时attributes参数用于：

• 保留原始launch中的特定属性
• 为合并后的新launch添加额外属性

自动化流水线集成实践

在实际CI/CD流水线中实现自动化合并时，建议采用以下流程：

1. 测试执行阶段：各测试节点使用相同属性集（如build_number/git_hash）上报结果
2. 结果收集阶段：通过属性过滤API获取相关launch ID列表
3. 强制完成阶段：确保所有测试进程状态正常
4. 合并操作阶段：调用merge API生成聚合报告

高级合并策略

ReportPortal支持多种合并策略，通过mergeType参数控制：

• BASIC：基础合并，保留各launch的原始结构
• DEEP：深度合并，会尝试合并测试用例级别的结果
• SUITE：套件合并，按测试套件组织结构合并

正确使用合并功能可以显著提升测试报告的可读性，特别是在分布式测试场景下，能够将同一构建产生的多个测试节点结果聚合成逻辑统一的报告视图。

常见问题解决方案

对于返回大量launch记录的情况，建议：

1. 增加精确的属性过滤条件
2. 结合时间范围参数缩小查询窗口
3. 实现分页处理机制

通过合理配置这些参数，开发者可以构建出高效可靠的自动化报告合并流程，避免手动操作带来的维护成本。