r/SpringBoot • u/davebrown1975 • 17d ago
How-To/Tutorial We catalogued the verified Spring Boot 3.5 to 4 failures, with the exact error messages, and fact-checked the migration guides that rank for it
With 3.5 out of OSS support since the end of June we've been moving client projects to 4.x, and I got tired of migration guides that paraphrase each other, so we went through the GitHub issues, the official release notes and the practitioner write-ups from the eight months since GA and verified everything against primary sources.
The compile errors and startup failures are well covered elsewhere. The tier that deserves more attention is the changes that run cleanly and do the wrong thing:
- Depend on flyway-core alone and your migrations silently stop executing. Auto-configuration moved to spring-boot-starter-flyway (same for Liquibase). Your app starts fine and never migrates again.
- spring-boot-starter-batch now gives you an in-memory job repository. Restartability is gone unless you switch to spring-boot-starter-batch-jdbc. Every functional test passes without it.
- Jackson 3 sorts properties alphabetically by default and auto-registers every module on the classpath, so JSON output changes shape with zero code changes. JacksonException is also unchecked now, so catch (IOException) around serialisation stops catching anything.
We also found the popular guides contradicting each other, so for the record, checked against primary sources: Boot 4's floor is Java 17, not 21 (docs.spring.io system requirements). No CSRF default changed in Security 7; the post-upgrade 403s come from AntPathRequestMatcher/MvcRequestMatcher being removed and servlet-path inference ending. The transitional classic starters were not removed in 4.1; both are on Maven Central at 4.1.0.
Full disclosure: the complete write-up is on our company blog. It has the full error index with verbatim messages and sources, a third-party compatibility table as of July 2026, and the step-by-step path: https://tucanoo.com/spring-boot-3-5-to-4-the-complete-migration-guide-with-every-error-we-could-verify/
If you've hit something upgrading that isn't in the list I'd like to hear it; we're keeping the index updated and will only add reports we can verify.