Why SpringBoot 3.0 Removed spring.factories and Introduced the Imports Mechanism

SpringBoot 3.0 brings a major change by removing the spring.factories file, which historically served as the core mechanism for auto‑configuration and extension registration.

The spring.factories file resides in META-INF/ and follows the Java SPI pattern, allowing developers to declare implementation classes for automatic loading.

Reasons for removal include:

Performance issues caused by scanning all JARs for the file during startup.

Incompatibility with the Java module system introduced in Java 9.

Static nature that prevents conditional loading without loading all classes.

Distributed configuration across many JARs makes management difficult.

Conflicts with GraalVM native image generation, which requires static analysis.

SpringBoot 3.0 introduces a new imports‑based mechanism. Each extension point now has its own file under META-INF/spring/ , such as AutoConfiguration.imports , containing one fully‑qualified class name per line.

Advantages of the imports approach are better startup performance, native module system support, simpler configuration syntax, and clearer organization.

Migration guide highlights moving entries from spring.factories to the appropriate .imports file, updating custom loaders, and using @AutoConfiguration instead of @Configuration where applicable.

Examples show old spring.factories syntax versus new imports files, as well as code snippets for custom auto‑configuration classes and Maven/Gradle settings for GraalVM native image builds.

SpringBoot’s new AOT processor reads imports files at build time, evaluates conditions, and generates proxies, reflection, and resource configurations, enabling efficient GraalVM native image compilation.

FAQ sections address compatibility with existing libraries, migration effort, and custom loader adaptation.

Overall, the removal of spring.factories and adoption of imports files modernize SpringBoot’s auto‑configuration, improve performance, and align the framework with modular Java and GraalVM native image requirements.