Quarkus中如何为测试类配置多个TestProfile？

DevOps 小满

2026-7-6

解决Quarkus中@TestProfile无法重复标注的问题

Quarkus的@TestProfile本身不支持重复标注，也不能直接指定多个Profile，但可以通过以下两种实用方案满足你的测试分类需求：

方案一：用JUnit @Tag做分类，@TestProfile做环境配置

这是最推荐的方式，把测试分类和环境配置解耦：

用JUnit的@Tag给测试类打多维度标签，比如@Tag("fast")、@Tag("slow")、@Tag("unit")、@Tag("integration")，一个测试类可以加多个标签（比如快速单元测试就加@Tag("fast")和@Tag("unit")）
@TestProfile只用来配置测试运行环境：比如单元测试用UnitTestProfile（禁用数据库、外部服务等集成组件），集成测试用IntegrationTestProfile（启用相关集成依赖），每个测试类只需要加一个对应环境的@TestProfile

运行测试时，通过JUnit的标签筛选功能就能指定要执行的测试集合，比如只运行快速单元测试：

# Maven
mvn test -Dgroups="fast,unit"
# Gradle
gradle test --tests "*" --include-tags "fast,unit"

方案二：自定义可重复注解包装@TestProfile

如果确实需要给测试类应用多个Profile的配置（比如合并多个Profile的属性、扩展配置），可以通过自定义可重复注解实现：

先定义容器注解：

import io.quarkus.test.junit.TestProfile;
import java.lang.annotation.*;

@Retention(RetentionPolicy.RUNTIME)
@Target(ElementType.TYPE)
public @interface TestProfiles {
    TestProfile[] value();
}

再定义可重复的包装注解：

import io.quarkus.test.junit.QuarkusTestProfile;
import java.lang.annotation.*;

@Repeatable(TestProfiles.class)
@Retention(RetentionPolicy.RUNTIME)
@Target(ElementType.TYPE)
public @interface TestProfileWrapper {
    Class<? extends QuarkusTestProfile> value();
}