自定义注解属性值自动注入@SpringBootTest的原理疑问

你的自定义@IntegrationTest注解能自动把properties属性值传递给@SpringBootTest，核心是Spring框架的元注解属性自动匹配传递机制，具体逻辑如下：

1. 元注解的层级关联 #

你给@IntegrationTest标注了@SpringBootTest作为元注解，这相当于告诉Spring：当测试类使用@IntegrationTest时，同时启用@SpringBootTest的全部功能。Spring在解析测试类的注解时，会递归处理所有元注解的配置逻辑。

2. 属性名与类型的匹配规则 #

@IntegrationTest中定义的properties属性，和@SpringBootTest中的properties属性名称完全一致，并且都是String[]类型。Spring的注解解析器会识别这种同名同类型的属性，自动将自定义注解的属性值"转发"给元注解的对应属性。

简单来说：你在@IntegrationTest(properties = {"my.property=value"})里填的值，Spring会自动帮你填充到@SpringBootTest(properties = {"my.property=value"})中，无需额外编写属性转发的代码。

3. 底层解析逻辑 #

Spring在处理注解时，会通过AnnotationUtils、MergedAnnotations等工具类递归扫描注解的元注解链。当发现自定义注解的属性与元注解的属性匹配时，会优先使用自定义注解的属性值覆盖元注解的默认值（如果有的话）。这种机制是Spring注解体系的通用特性，不止适用于测试注解，在@Configuration、@Controller等注解的自定义组合中也同样生效。

举个更直观的扩展例子，假设你给@IntegrationTest新增一个和@SpringBootTest同名的属性：

@Target(ElementType.TYPE)
@Retention(RetentionPolicy.RUNTIME)
@SpringBootTest
@AutoConfigureMockMvc
@ActiveProfiles("integration-test")
public @interface IntegrationTest {

    String[] properties() default {};
    // 新增与@SpringBootTest同名的webEnvironment属性
    SpringBootTest.WebEnvironment webEnvironment() default SpringBootTest.WebEnvironment.MOCK;
}

使用时：

@IntegrationTest(webEnvironment = SpringBootTest.WebEnvironment.RANDOM_PORT)
public class MyIntegrationTest {
    // 此时@SpringBootTest的webEnvironment会自动被设为RANDOM_PORT
}

这同样会生效，核心还是属性名与类型的匹配规则。

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