Spring Boot 4.x

Recipes for migrating to Spring Boot 4.

Composite Recipes

Recipes that include further recipes, often including the individual recipes below.

• Add Jackson2 for Jersey using JSON
• Add MongoDB representation properties for UUID and BigDecimal
• Add Spring Boot 4.0 modular starter dependencies
• Add Spring Boot 4.0 modular starters
• Add spring-boot-starter-data-mongodb-reactive-test for reactive MongoDB tests
• Add spring-boot-starter-data-mongodb-test for imperative MongoDB tests
• Add spring-boot-starter-validation dependency
• Adopt Jackson 3
• Co-exclude UserDetailsServiceAutoConfiguration where SecurityAutoConfiguration is excluded
• Comment out deprecated DevTools LiveReload properties
• Migrate MockMvc to AssertJ assertions
• Migrate PropertyMapper API for Spring Boot 4.0
• Migrate Spring Boot properties to 4.0
• Migrate Spring Boot properties to 4.1 (Moderne Edition)
• Migrate Spring Boot properties to 4.1 (Community Edition)
• Migrate Spring Cloud AWS (awspring) to 4.0
• Migrate Spring Retry to Spring Resilience
• Migrate Spring Session Hazelcast to Hazelcast Spring Session
• Migrate from standalone Spring gRPC 1.0 to Spring Boot 4.1 (Spring gRPC 1.1)
• Migrate packages to modular starters
• Migrate to Spring Boot 4.0 (Moderne Edition)
• Migrate to Spring Boot 4.0 (Community Edition)
• Migrate to Spring Boot 4.0 modular starters (Moderne Edition)
• Migrate to Spring Boot 4.0 modular starters (Community Edition)
• Migrate to Spring Boot 4.1
• Migrate to Spring Boot 4.1 modular starters
• Migrate to Spring Kafka 4.0
• Migrate to Spring Kafka 4.1
• Modularize legacy raw Spring Data Redis dependency
• Module has monolithic Spring Boot starter
• Module uses Flyway
• Module uses Liquibase
• Relocate Spring Boot web server classes to their Spring Boot 4.0 packages
• Remove Spring Pulsar Reactive support
• Remove SslBundles parameter from KafkaProperties build methods
• Remove the orphaned Spring Retry version pin
• Rename Spring Boot 4.0 starters with managed versions
• Replace @MockBean and @SpyBean
• Replace deprecated RequestMatcherProvider with new API
• Split the Spring gRPC test starter into server-test and client-test starters
• Split the combined Spring gRPC starter into server and client starters
• Spring Boot 4.0 Module Starter Relocations
• Spring Boot 4.0 best practices
• Upgrade MyBatis to Spring Boot 4.0

Recipes

• Add @AutoConfigureMockMvc if necessary (Community Edition)
• Add @AutoConfigureMockMvc to @SpringBootTest classes using MockMvc (Moderne Edition)
• Add @AutoConfigureTestRestTemplate if necessary
• Add @AutoConfigureWebTestClient if necessary
• Add @MockitoSettings(strictness = Strictness.LENIENT) for @MockitoBean tests
• Add Flyway starters
• Add Liquibase starters
• Add explicit version for REST Assured
• Add spring-boot-starter-flyway if using Flyway
• Add useDefaultJaasConfig=true to MSSQL Kerberos JDBC URLs
• Co-exclude UserDetailsServiceAutoConfiguration on auto-configuration exclusion annotations
• Expand split spring.autoconfigure.exclude entries for Spring Boot 4.0
• Flag deprecated ReactorNettyHttpClientMapper for migration
• Flag gRPC client stub injections that need @ImportGrpcClients
• Migrate @AutoConfigureMockMvc HtmlUnit attributes to nested @HtmlUnit
• Migrate @Retryable(recover=...) + @Recover to programmatic RetryTemplate
• Migrate JsonFactoryDecorator to TokenStreamFactoryBuilderDecorator
• Migrate MockMvc andExpect() chains to AssertJ assertions
• Migrate MockMvc to MockMvcTester
• Migrate MockMvcRequestBuilders to MockMvcTester request methods
• Migrate OpenAPI Generator spring configuration to Spring Boot 4
• Migrate Spring gRPC client channel properties to 1.1
• Migrate a Spring Boot 3 jackson-bom.version override to jackson-2-bom.version
• Migrate awspring SQS default converter setObjectMapper to constructor injection
• Migrate jsonschema2pojo configuration to Spring Boot 4
• Migrate layertools jarmode to tools
• Migrate spring-retry to Spring Framework resilience
• Preserve PropertyMapper null-passing behavior
• Preserve system-proxy defaults on Reactor HTTP client builders
• Preserve system-proxy defaults on Reactor HTTP client builders
• Read servlet web server factory settings through getSettings()
• Remove @Bean methods for modules built-in to Jackson 3
• Remove ContentNegotiationConfigurer.favorPathExtension() calls
• Remove HttpMessageConvertersAutoConfiguration references
• Remove ZipkinAutoConfiguration
• Remove loaderImplementation from Gradle
• Replace deprecated DockerApi
• Replace deprecated ThreadPoolTaskSchedulerBuilder constructor
• Replace deprecated org.springframework.boot.autoconfigure.mongo API
• Replace removed RedisCacheConfiguration.getTtl()
• Simplify null checks on Optional @ConfigurationProperties parameters
• Split spring.grpc.server.address into address and port
• Unwrap @MockBeans and @SpyBeans container annotations
• Upgrade to Java 21 when using jOOQ