Migration Guide

Guide for upgrading to Spring Boot AutoConfigure 4.0.2.

From Spring Boot 3.x

Key Changes

1. Java 17 Minimum: Java 17 or later required
2. Jakarta EE: Migrated from javax.* to jakarta.*
3. Auto-Configuration Registration: Now uses AutoConfiguration.imports file

Update Dependencies

<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-autoconfigure</artifactId>
    <version>4.0.2</version>
</dependency>

Update Imports

// Old
import javax.servlet.*;
import javax.persistence.*;

// New
import jakarta.servlet.*;
import jakarta.persistence.*;

Update Auto-Configuration Registration

Old (spring.factories):

org.springframework.boot.autoconfigure.EnableAutoConfiguration=\
  com.example.MyAutoConfiguration

New (META-INF/spring/org.springframework.boot.autoconfigure.AutoConfiguration.imports):

com.example.MyAutoConfiguration

Breaking Changes

1. Configuration Properties

Some property names changed:

# Old
spring.jpa.hibernate.use-new-id-generator-mappings=true

# New
spring.jpa.hibernate.id.new-generator-mappings=true

2. Deprecated APIs Removed

Check for removed deprecated methods and classes.

See Also

• Quick Start
• Configuration Basics