Close

Spring Boot - Auto-configuration with @SpringBootApplication

[Last Updated: Nov 9, 2026]

Most Spring Boot applications use @EnableAutoConfiguration and @ComponentScan together. To save us from writing them every time, Spring Boot gives us one shortcut annotation: @SpringBootApplication. It is a meta-annotation, which means an annotation that is built from other annotations.


What is inside @SpringBootApplication?

When we use @SpringBootApplication, we get these three annotations at once:

  • @SpringBootConfiguration - marks the class as a configuration class (a special kind of @Configuration), so we can declare beans in it.
  • @EnableAutoConfiguration - tells Spring Boot to configure beans automatically, based on the libraries found on the classpath.
  • @ComponentScan - finds our components (@Component, @Service, @Controller and so on) in the package of this class and in all its sub-packages.

Definition of SpringBootApplication

Version: 4.1.2
 package org.springframework.boot.autoconfigure;
 @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 = EnableAutoConfiguration.class)
     Class<?>[] exclude() default {}; 1
     @AliasFor(annotation = EnableAutoConfiguration.class)
     String[] excludeName() default {}; 2
     @AliasFor(annotation = ComponentScan.class, attribute = "basePackages")
     String[] scanBasePackages() default {}; 3
     @AliasFor(annotation =
         ComponentScan.class, attribute = "basePackageClasses")
     Class<?>[] scanBasePackageClasses() default {}; 4
     @AliasFor(annotation = ComponentScan.class, attribute = "nameGenerator")
     Class<? extends BeanNameGenerator> nameGenerator()
                                        default BeanNameGenerator.class; 5
     @AliasFor(annotation = Configuration.class)
     boolean proxyBeanMethods() default true; 6
 }
1Exclude specific auto-configuration classes such that they will never be applied.
2Exclude specific auto-configuration class names such that they will never be applied. (Since 1.3.0)
3Base packages to scan for annotated components. (Since 1.3.0)
4Type-safe alternative to #scanBasePackages for specifying the packages to scan for annotated components. (Since 1.3.0)
5The BeanNameGenerator class to be used for naming detected components within the Spring container. (Since 2.3.0)
6Specify whether @Bean methods should get proxied in order to enforce bean lifecycle behavior, e.g. to return shared singleton bean instances even in case of direct @Bean method calls in user code. (Since 2.2)

Example

<?xml version="1.0" encoding="UTF-8"?>
<project xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd" xmlns="http://maven.apache.org/POM/4.0.0"
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
  <modelVersion>4.0.0</modelVersion>
  <parent>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-parent</artifactId>
    <version>4.1.2</version>
  </parent>
  <groupId>com.logicbig.example</groupId>
  <artifactId>spring-boot-annotation</artifactId>
  <version>1.0-SNAPSHOT</version>
  <properties>
    <java.version>25</java.version>
  </properties>
  <dependencies>
    <dependency>
      <groupId>org.springframework.boot</groupId>
      <artifactId>spring-boot-starter-web</artifactId>
    </dependency>
  </dependencies>
</project>
plugins {
    java
    id("org.springframework.boot") version "4.1.2"
    id("io.spring.dependency-management") version "1.1.7"
}

println(">>> EXECUTING SCRIPT: build.gradle.kts (Kotlin DSL)")

group = "com.logicbig.example"
version = "1.0-SNAPSHOT"

java {
    sourceCompatibility = JavaVersion.VERSION_25
}

repositories {
    mavenCentral()
}

dependencies {
    implementation("org.springframework.boot:spring-boot-starter-web")
}
plugins {
    id 'java'
    id 'org.springframework.boot' version '4.1.2'
    id 'io.spring.dependency-management' version '1.1.7'
}

println ">>> EXECUTING SCRIPT: build.gradle (Groovy DSL)"

group = 'com.logicbig.example'
version = '1.0-SNAPSHOT'

java {
    sourceCompatibility = JavaVersion.VERSION_25
}

repositories {
    mavenCentral()
}

dependencies {
    implementation 'org.springframework.boot:spring-boot-starter-web'
}

package com.logicbig.example;

import org.springframework.stereotype.Component;

@Component
public class MyBean {
    public String getMessage () {
        return "a message from MyBean";
    }
}
package com.logicbig.example;

import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.ResponseBody;

@Controller
public class MyWebController {

    @Autowired
    private MyBean myBean;

    @RequestMapping("/")
    @ResponseBody
    public String theHandler () {
        return myBean.getMessage();
    }
}
package com.logicbig.example;

import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;

@SpringBootApplication
public class EnabledAutoConfigExample {

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

Running the example

To run Spring Boot application you can run your main class from IDE, or execute it from the command line using your build tool:

  • Maven: mvn spring-boot:run
  • Gradle: gradle bootRun

Output


. ____ _ __ _ _
/\\ / ___'_ __ _ _(_)_ __ __ _ \ \ \ \
( ( )\___ | '_ | '_| | '_ \/ _` | \ \ \ \
\\/ ___)| |_)| | | | | || (_| | ) ) ) )
' |____| .__|_| |_|_| |_\__, | / / / /
=========|_|==============|___/=/_/_/_/

:: Spring Boot :: (v4.1.2)

2026-11-05T08:00:25.061-06:00 INFO 1552 --- [ main] c.l.example.EnabledAutoConfigExample : Starting EnabledAutoConfigExample using Java 25 with PID 1552 (D:\LogicBig\example-projects\spring-boot\spring-boot-annotation\target\classes started by joe2 in D:\LogicBig\example-projects\spring-boot\spring-boot-annotation)
2026-11-05T08:00:25.070-06:00 INFO 1552 --- [ main] c.l.example.EnabledAutoConfigExample : No active profile set, falling back to 1 default profile: "default"
2026-11-05T08:00:26.077-06:00 INFO 1552 --- [ main] o.s.boot.tomcat.TomcatWebServer : Tomcat initialized with port 8080 (http)
2026-11-05T08:00:26.095-06:00 INFO 1552 --- [ main] o.apache.catalina.core.StandardService : Starting service [Tomcat]
2026-11-05T08:00:26.095-06:00 INFO 1552 --- [ main] o.apache.catalina.core.StandardEngine : Starting Servlet engine: [Apache Tomcat/11.0.27]
2026-11-05T08:00:26.145-06:00 INFO 1552 --- [ main] b.w.c.s.WebApplicationContextInitializer : Root WebApplicationContext: initialization completed in 1010 ms
2026-11-05T08:00:26.532-06:00 INFO 1552 --- [ main] o.s.boot.tomcat.TomcatWebServer : Tomcat started on port 8080 (http) with context path '/'
2026-11-05T08:00:26.537-06:00 INFO 1552 --- [ main] c.l.example.EnabledAutoConfigExample : Started EnabledAutoConfigExample in 1.909 seconds (process running for 2.337)

Accessing http://localhost:8080


Output
$ curl -s "http://localhost:8080"
a message from MyBean

Changing the scan packages

Just like the @ComponentScan elements basePackageClasses and basePackages, the @SpringBootApplication annotation has scanBasePackageClasses and scanBasePackages. We use them when our components are not in the package of the main class (or in its sub-packages). Note that if we set one of them, the default scan of the main class package is replaced by our setting.

@SpringBootApplication(scanBasePackages = "com.logicbig.other")
public class EnabledAutoConfigExample {
   ....
}

Version history

This is how @SpringBootApplication and the related setup changed over the years. The tutorial above uses the modern way.

  • Spring Boot 1.0 and 1.1 (2014): There was no @SpringBootApplication. We had to write @Configuration, @EnableAutoConfiguration and @ComponentScan on the main class.
  • Spring Boot 1.2: @SpringBootApplication was introduced as a shortcut for those three annotations.
  • Spring Boot 1.3: the elements scanBasePackages and scanBasePackageClasses were added.
  • Spring Boot 1.4: @SpringBootConfiguration was introduced and replaced @Configuration inside @SpringBootApplication.
  • Spring Boot 2.2: the element proxyBeanMethods was added. Setting it to false can make startup a little faster for configuration classes.
  • Spring Boot 2.4: the .RELEASE suffix was dropped from version numbers (for example 2.4.0 instead of 2.3.0.RELEASE).
  • Spring Boot 3.0: Java 17 became the minimum version, and Java EE (javax.*) packages changed to Jakarta EE (jakarta.*). Auto-configuration classes are now listed in META-INF/spring/org.springframework.boot.autoconfigure.AutoConfiguration.imports instead of spring.factories.
  • Spring Boot 4.0 (November 2025): It is based on Spring Framework 7 and Jakarta EE 11. Spring Boot was split into smaller modules, and some starters were renamed. For example, spring-boot-starter-web is now spring-boot-starter-webmvc.

Example Project

Dependencies and Technologies Used:

  • Spring Boot 4.1.2
    Corresponding Spring Framework Version 7.0.10
     Version Compatibility: 2.0.0.RELEASE - 4.1.2Version List
    ×

    Version compatibilities of spring-boot-starter-parent with this example:

    • 2.0.0.RELEASE
    • 2.0.1.RELEASE
    • 2.0.2.RELEASE
    • 2.0.3.RELEASE
    • 2.0.4.RELEASE
    • 2.0.5.RELEASE
    • 2.0.6.RELEASE
    • 2.0.7.RELEASE
    • 2.0.8.RELEASE
    • 2.0.9.RELEASE
    • 2.1.0.RELEASE
    • 2.1.1.RELEASE
    • 2.1.2.RELEASE
    • 2.1.3.RELEASE
    • 2.1.4.RELEASE
    • 2.1.5.RELEASE
    • 2.1.6.RELEASE
    • 2.1.7.RELEASE
    • 2.1.8.RELEASE
    • 2.1.9.RELEASE
    • 2.1.10.RELEASE
    • 2.1.11.RELEASE
    • 2.1.12.RELEASE
    • 2.1.13.RELEASE
    • 2.1.14.RELEASE
    • 2.1.15.RELEASE
    • 2.1.16.RELEASE
    • 2.1.17.RELEASE
    • 2.1.18.RELEASE
    • 2.2.0.RELEASE
    • 2.2.1.RELEASE
    • 2.2.2.RELEASE
    • 2.2.3.RELEASE
    • 2.2.4.RELEASE
    • 2.2.5.RELEASE
    • 2.2.6.RELEASE
    • 2.2.7.RELEASE
    • 2.2.8.RELEASE
    • 2.2.9.RELEASE
    • 2.2.10.RELEASE
    • 2.2.11.RELEASE
    • 2.2.12.RELEASE
    • 2.2.13.RELEASE
    • 2.3.0.RELEASE
    • 2.3.1.RELEASE
    • 2.3.2.RELEASE
    • 2.3.3.RELEASE
    • 2.3.4.RELEASE
    • 2.3.5.RELEASE
    • 2.3.6.RELEASE
    • 2.3.7.RELEASE
    • 2.3.8.RELEASE
    • 2.3.9.RELEASE
    • 2.3.10.RELEASE
    • 2.3.11.RELEASE
    • 2.3.12.RELEASE
    • 2.4.0
    • 2.4.1
    • 2.4.2
    • 2.4.3
    • 2.4.4
    • 2.4.5
    • 2.4.6
    • 2.4.7
    • 2.4.8
    • 2.4.9
    • 2.4.10
    • 2.4.11
    • 2.4.12
    • 2.4.13
    • 2.5.0
    • 2.5.1
    • 2.5.2
    • 2.5.3
    • 2.5.4
    • 2.5.5
    • 2.5.6
    • 2.5.7
    • 2.5.8
    • 2.5.9
    • 2.5.10
    • 2.5.11
    • 2.5.12
    • 2.5.13
    • 2.5.14
    • 2.5.15
    • 2.6.0
    • 2.6.1
    • 2.6.2
    • 2.6.3
    • 2.6.4
    • 2.6.5
    • 2.6.6
    • 2.6.7
    • 2.6.8
    • 2.6.9
    • 2.6.10
    • 2.6.11
    • 2.6.12
    • 2.6.13
    • 2.6.14
    • 2.6.15
    • 2.7.0
    • 2.7.1
    • 2.7.2
    • 2.7.3
    • 2.7.4
    • 2.7.5
    • 2.7.6
    • 2.7.7
    • 2.7.8
    • 2.7.9
    • 2.7.10
    • 2.7.11
    • 2.7.12
    • 2.7.13
    • 2.7.14
    • 2.7.15
    • 2.7.16
    • 2.7.17
    • 2.7.18
    • Java 17 min
    • 3.0.0
    • 3.0.1
    • 3.0.2
    • 3.0.3
    • 3.0.4
    • 3.0.5
    • 3.0.6
    • 3.0.7
    • 3.0.8
    • 3.0.9
    • 3.0.10
    • 3.0.11
    • 3.0.12
    • 3.0.13
    • 3.1.0
    • 3.1.1
    • 3.1.2
    • 3.1.3
    • 3.1.4
    • 3.1.5
    • 3.1.6
    • 3.1.7
    • 3.1.8
    • 3.1.9
    • 3.1.10
    • 3.1.11
    • 3.1.12
    • 3.2.0
    • 3.2.1
    • 3.2.2
    • 3.2.3
    • 3.2.4
    • 3.2.5
    • 3.2.6
    • 3.2.7
    • 3.2.8
    • 3.2.9
    • 3.2.10
    • 3.2.11
    • 3.2.12
    • 3.3.0
    • 3.3.1
    • 3.3.2
    • 3.3.3
    • 3.3.4
    • 3.3.5
    • 3.3.6
    • 3.3.7
    • 3.3.8
    • 3.3.9
    • 3.3.10
    • 3.3.11
    • 3.3.12
    • 3.3.13
    • 3.4.0
    • 3.4.1
    • 3.4.2
    • 3.4.3
    • 3.4.4
    • 3.4.5
    • 3.4.6
    • 3.4.7
    • 3.4.8
    • 3.4.9
    • 3.4.10
    • 3.4.11
    • 3.4.12
    • 3.4.13
    • 3.5.0
    • 3.5.1
    • 3.5.2
    • 3.5.3
    • 3.5.4
    • 3.5.5
    • 3.5.6
    • 3.5.7
    • 3.5.8
    • 3.5.9
    • 3.5.10
    • 3.5.11
    • 3.5.12
    • 3.5.13
    • 3.5.14
    • 3.5.15
    • 3.5.16
    • 4.0.0
    • 4.0.1
    • 4.0.2
    • 4.0.3
    • 4.0.4
    • 4.0.5
    • 4.0.6
    • 4.0.7
    • 4.0.8
    • 4.0.9
    • 4.1.0
    • 4.1.1
    • 4.1.2

    Versions in green have been tested.

  • spring-boot-starter-web (Starter for building web, including RESTful, applications using Spring MVC. Uses Tomcat as the default embedded container (deprecated in favor of spring-boot-starter-webmvc))
  • JDK 25

Build Tool:
Spring MVC - @SpringBootAnnotation Example Select All Download
  • spring-boot-annotation
    • src
      • main
        • java
          • com
            • logicbig
              • example
                • EnabledAutoConfigExample.java

    See Also

    Join