如何在JUnit5与CitrusExtension全局上下文中使用属性文件值？

我来帮你理清在JUnit5搭配CitrusExtension的环境下，怎么让你的配置类和测试类正确加载并使用属性文件里的值，分几个实用步骤来操作：

你的RestEndpointConfig是Spring配置类，但JUnit5+CitrusExtension默认不会自动扫描它。你需要在测试类上添加@SpringJUnitConfig注解，指定要加载的配置类，这样Spring会自动处理@PropertySource注解，把属性文件里的值加载到上下文里。另外注意：JUnit5里不需要@RunWith(JUnitPlatform.class)了，@ExtendWith(CitrusExtension.class)就足够让Citrus和JUnit5协同工作。

示例测试类：

@ExtendWith(CitrusExtension.class)
@SpringJUnitConfig(classes = RestEndpointConfig.class)
public class YourCitrusIntegrationTest {
    // 测试代码写在这里
}

既然已经注入了属性值，你可以把需要用到的Rest端点配置封装成Citrus的RestEndpoint Bean，这样测试里直接注入就能用，不用重复拼接地址。比如：

@Configuration
@PropertySource("classpath:test-setup.properties")
@PropertySource("classpath:service-paths.properties")
public class RestEndpointConfig {

    @Value("${testenv.host}")
    private String host;

    @Value("${service.paths.user-service}") // 假设service-paths里有这个属性
    private String userServicePath;

    @Bean
    public RestEndpoint userServiceEndpoint() {
        return CitrusEndpoints.rest()
                .client()
                .requestUrl(host + userServicePath)
                .build();
    }
}

小提示：属性文件路径最好加上classpath:前缀，确保Spring能从测试资源目录（src/test/resources）正确找到文件。

现在Spring上下文已经加载了配置，你有两种方式使用属性值：

方式一：注入配置好的RestEndpoint Bean #

这种方式最省心，直接用封装好的端点：

@ExtendWith(CitrusExtension.class)
@SpringJUnitConfig(classes = RestEndpointConfig.class)
public class UserServiceTest {

    @Autowired
    private RestEndpoint userServiceEndpoint;

    @CitrusTest
    public void testCreateUser() {
        citrusActions()
                .http()
                .post(userServiceEndpoint)
                .payload("{\"username\": \"citrus_test\"}")
                .accept(MediaType.APPLICATION_JSON)
                .validateStatusCode(HttpStatus.OK);
    }
}

方式二：直接注入属性值 #

如果需要在测试里直接用原始属性值，也可以用@Value注入：

@ExtendWith(CitrusExtension.class)
@SpringJUnitConfig(classes = RestEndpointConfig.class)
public class UserServiceTest {

    @Value("${testenv.host}")
    private String testHost;

    @CitrusTest
    public void testCreateUser() {
        citrusActions()
                .http()
                .post(testHost + "/api/users")
                .payload("{\"username\": \"citrus_test\"}")
                .accept(MediaType.APPLICATION_JSON);
    }
}

如果你的属性比较多，用@Value一个个注入会很繁琐，推荐用@ConfigurationProperties来批量绑定：

@Configuration
@PropertySource("classpath:test-setup.properties")
@ConfigurationProperties(prefix = "testenv")
public class RestEndpointConfig {
    // 自动绑定testenv.host属性
    private String host;
    // 自动绑定testenv.port属性（如果有的话）
    private int port;

    // 记得加getter和setter
    public String getHost() { return host; }
    public void setHost(String host) { this.host = host; }
    public int getPort() { return port; }
    public void setPort(int port) { this.port = port; }

    @Bean
    public RestEndpoint userServiceEndpoint() {
        return CitrusEndpoints.rest()
                .client()
                .requestUrl(String.format("%s:%d/api/users", host, port))
                .build();
    }
}

这种方式更优雅，也更容易维护。

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