Understanding the @SpringBootApplication Annotation in Spring Boot

Almost all Spring Boot applications add the @SpringBootApplication annotation on the main class; it is the core annotation that combines several other annotations.

Understanding its semantics: it is equivalent to @EnableAutoConfiguration, @ComponentScan, and @SpringBootConfiguration (which itself is meta‑annotated with @Configuration). The article shows the source of the annotation and explains how component scanning and auto‑configuration are triggered.

Typical Spring Boot main class example:

@SpringBootApplication
public class SpringBootDemoApplication {
    public static void main(String[] args) {
        SpringApplication.run(SpringBootDemoApplication.class, args);
    }
}

The definition of @SpringBootApplication and related meta‑annotations is presented, including how @ComponentScan is configured with excludeFilters and how attribute aliasing works with @AliasFor:

@Target(ElementType.TYPE)
@Retention(RetentionPolicy.RUNTIME)
@Documented
@Inherited
@SpringBootConfiguration
@EnableAutoConfiguration
@ComponentScan(excludeFilters = {
    @Filter(type = FilterType.CUSTOM, classes = TypeExcludeFilter.class),
    @Filter(type = FilterType.CUSTOM, classes = AutoConfigurationExcludeFilter.class)
})
public @interface SpringBootApplication {
    @AliasFor(annotation = ComponentScan.class, attribute = "basePackages")
    String[] scanBasePackages() default {};
}

The article explains that the annotation can be placed on any configuration class, not only the main class, and demonstrates how to create a custom composite annotation to replace @SpringBootApplication:

@Target(ElementType.TYPE)
@Retention(RetentionPolicy.RUNTIME)
@Documented
@Inherited
@Configuration
@EnableAutoConfiguration
@ComponentScan
public @interface CustomSpringBootApplication {}

Finally, it discusses the Spring annotation programming model, the component scanning process, and the auto‑configuration mechanism, illustrating how Spring Boot automatically registers beans based on classpath detection and the @EnableAutoConfiguration annotation.