ReportPortal中测试失败未标记为"待调查"的问题解析

在ReportPortal 5.12.0版本中，用户反馈了一个重要问题：当测试用例执行失败时，系统未能自动将其标记为"待调查"(To Investigate)状态。这个问题影响了团队对失败测试用例的后续处理流程。

问题现象

用户在使用ReportPortal 5.12.0版本时发现，失败的测试用例不会像之前版本(如5.11.1)那样自动标记为"待调查"状态。用户需要手动将测试状态从"通过"切换到"失败"，才能触发"待调查"标记。这种异常行为影响了测试结果的自动化处理流程。

根本原因分析

经过技术团队深入调查，发现这个问题与ReportPortal 5.12.0版本中引入的行为变更有关。新版本调整了"待调查"标记的触发逻辑，现在这一功能专门设计用于处理类型为"STEP"的测试项。

在之前的版本中，无论测试项类型如何，失败的测试都会被自动标记为"待调查"。但在5.12.0版本中，这一行为被修改为仅对"STEP"类型的测试项有效。这一变更旨在使"待调查"功能更加精准地作用于实际测试步骤层面。

解决方案

对于使用Cucumber等测试框架的用户，需要确保测试项的类型设置为"STEP"而非"SCENARIO"。具体修改方法取决于使用的客户端库和测试框架集成方式。

以JavaScript客户端为例，在测试代码中应明确指定测试项类型为"STEP"：

const testItem = {
  name: "测试用例名称",
  type: "STEP",  // 必须设置为STEP类型
  // 其他属性...
};

最佳实践建议

1. 测试项类型选择：对于实际的测试执行步骤，始终使用"STEP"类型，以确保ReportPortal的所有自动化功能(包括"待调查"标记)能够正常工作。

2. 版本升级注意事项：从ReportPortal 5.11.1升级到5.12.0或更高版本时，应检查现有测试项的类型设置，必要时进行调整。

3. 命名规范：虽然"STEP"这一命名可能不够直观，但它是ReportPortal中表示实际测试执行步骤的标准类型。团队可以考虑在内部文档中记录这一约定，以避免混淆。

总结

ReportPortal 5.12.0版本对"待调查"标记的行为进行了优化，使其更加专注于测试步骤层面。这一变更虽然初期可能造成困惑，但从长远来看有助于提高测试结果处理的精确性。开发团队应相应调整测试代码，确保测试项类型设置正确，以充分利用ReportPortal提供的自动化功能。

对于使用Cucumber等BDD框架的团队，特别需要注意场景(Scenario)和步骤(Step)在ReportPortal中的类型映射关系，确保测试结果能够得到正确处理和分析。