如何将Serenity 1.5.11的RestConfigurationRule迁移至2.6.0适配JUnit5

问题根源 #

Serenity 2.x版本全面适配JUnit5之后，移除了原有JUnit4体系下的RestConfigurationRule规则类，原规则的配置能力已经整合到SerenityRest静态工具类中，不需要再通过JUnit Rule实现。

解决步骤 #

• 删除原有Rule代码
  删掉你现有测试类中的以下代码段：

@Rule
public final RestConfigurationRule rule = new RestConfigurationRule(new TestConfiguration(),
    new LogConfiguration(), new RelaxedHttpsConfiguration());

• 替换为JUnit5的初始化配置
  在测试类中添加@BeforeEach注解的初始化方法，通过SerenityRest加载你需要的三类配置：

import net.serenitybdd.rest.SerenityRest;
import org.junit.jupiter.api.BeforeEach;

// 你的测试类定义
public class YourTestClass {

    @BeforeEach
    void initRestConfig() {
        SerenityRest.useConfiguration(new TestConfiguration());
        SerenityRest.useConfiguration(new LogConfiguration());
        SerenityRest.useConfiguration(new RelaxedHttpsConfiguration());
    }

    // 原有测试方法保持不变
}

如果所有测试类都需要相同的配置，也可以把这段初始化逻辑放到公共测试父类中，避免重复代码。

• 可选优化：全局配置替代代码配置
  如果不需要针对单个测试类做特殊配置，你也可以直接在项目的serenity.properties或serenity.conf中配置对应参数，完全省去代码层面的配置：

# 放松HTTPS校验
serenity.relaxed.https=true
# Rest请求日志级别，可取值OFF/BASIC/HEADERS/ALL
serenity.rest.log.level=ALL
# 全局测试基础路径
serenity.rest.base.url=https://你的测试接口域名

额外兼容性优化建议 #

你当前POM中使用的是第三方维护的serenity-junit5依赖，Serenity 2.4.x之后官方已经提供原生JUnit5支持，建议替换为官方依赖避免版本不兼容问题，修改POM依赖如下：

<!-- 删掉原来的io.github.fabianlinz的serenity-junit5依赖，替换为以下官方依赖 -->
<dependency>
    <groupId>net.serenity-bdd</groupId>
    <artifactId>serenity-junit5</artifactId>
    <version>${serenity.version}</version>
    <scope>test</scope>
</dependency>

内容的提问来源于stack exchange，提问作者Nikita