Spring Boot 揭秘与实战源码分析 - 工作原理剖析-优快云博客

本文深入探讨SpringBoot的自动配置机制，以FreeMarker为例，详细分析了@EnableAutoConfiguration的作用及其实现原理，包括如何通过spring.factories文件扫描自动配置项。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

结合《Spring Boot 揭秘与实战源码分析 - 开箱即用，内藏玄机》一文，我们再来深入的理解 Spring Boot 的工作原理。

博客地址：blog.720ui.com/

在《Spring Boot 揭秘与实战源码分析 - 开箱即用，内藏玄机》一文，我们了解到 Spring Boot 提供了很多开箱即用的依赖模块，开发者只要在 Maven 的 pom 文件中添加相关依赖后，Spring Boot 就会针对这个应用自动创建和注入需要的 Spring Bean 到上下文中。

这篇，我们以 FreeMarker 的自动配置为例，重点讲解工作原理与加载过程。因为 FreeMarker 相对而言比较简单，Spring Boot 源码中只有三个类，所以作为案例相对而言比较好理解。

EnableAutoConfiguration 帮助我们做了什么

你还记得 @EnableAutoConfiguration 注解么？

我们先来回顾下。

@RestController
@EnableAutoConfiguration
@ComponentScan(basePackages = { "com.lianggzone.springboot" })
public class WebMain {
    public static void main(String[] args) throws Exception {
        SpringApplication.run(WebMain.class, args);
    }
}复制代码

那么，现在我们剖析下 @EnableAutoConfiguration 的源码。

这里，关键在于 @Import 注解导入的 EnableAutoConfigurationImportSelector 类中最为关键的是 getCandidateConfigurations 方法中通过 SpringFactoriesLoader.loadFactoryNames 扫描 spring.factories 文件。

现在，我们在来看下 SpringFactoriesLoader 源码。

突然，你是不是发现 spring.factories 文件是相当重要呢？对的，Spring Boot 通过扫描这个文件中的内容，判断有哪些自动配置。以 FreeMarker 为例，我们来看下它是如何配置的。

所以，Spring Boot 通过扫描 spring.factories 文件中的 EnableAutoConfiguration 参数中有哪些自动配置并进行加载。

配置参数类 – FreeMarkerProperties

这里的配置参数，可以通过application.properties 中直接设置。我们发现，它的前缀必须是 spring.freemarker。

自动配置类 – FreeMarkerAutoConfiguration

核心注解

在《Spring Boot 揭秘与实战源码分析 - 开箱即用，内藏玄机》一文，有提到 @ConditionalOnClass 参数中对应的类在 classpath 目录下存在时，才会去解析对应的配置类，否则不解析该注解修饰的配置类。

Spring Boot 内部提供了很多自动化配置的类，例如，RedisAutoConfiguration 、MongoRepositoriesAutoConfiguration 、ElasticsearchAutoConfiguration ，这些自动化配置的类会判断 classpath 中是否存在自己需要的那个类，如果存在则会自动配置相关的配置，否则就不会自动配置，因此，开发者在 Maven 的 pom 文件中添加相关依赖后，这些依赖就会下载很多 jar 包到 classpath 中，有了这些 lib 就会触发自动化配置，所以，我们就能很便捷地使用对于的模块功能了。

此外，还有一个主要的注解是 @EnableConfigurationProperties ，主要用来加载我们上面提到的配置参数类。