Java Academy · 课时

自动配置与 Spring Boot 启动器

了解 Spring Boot 如何根据类路径依赖和条件注解自动配置 Bean

自动配置与 Spring Boot 启动器 是 CoddyKit 上的免费 Java Academy 课时。这是第 1 节课，共 4 节。你可以在下方免费阅读本课时的完整内容 — 然后在浏览器中使用内置代码编辑器和全天候 AI 导师进行实践。这是 Java Academy 学习路径的一部分，你的进度在网页和 CoddyKit 应用中同步。 Java Academy 课程共包含 4 节课。

什么是 Spring Boot 自动配置

自动配置会根据类路径和环境中存在的内容，自动配置 Spring Bean。对于常见集成，它可以省去手动设置 @Bean 的工作。

@SpringBootApplication 注解

@SpringBootApplication 是 @Configuration、@EnableAutoConfiguration 和 @ComponentScan 的组合注解。它会启用自动配置和组件扫描。

@SpringBootApplication
public class MyApp {
    public static void main(String[] args) {
        SpringApplication.run(MyApp.class, args);
    }
}

自动配置的工作方式

Spring Boot 会扫描 META-INF/spring/org.springframework.boot.autoconfigure.AutoConfiguration.imports（Spring Boot 3），以获取自动配置类列表。每个类都会根据条件选择性地应用。

// Spring Boot 3 imports file:
// org.springframework.boot.autoconfigure.jdbc.DataSourceAutoConfiguration
// org.springframework.boot.autoconfigure.web.servlet.WebMvcAutoConfiguration

@ConditionalOnClass 与 @ConditionalOnMissingBean

自动配置类使用 @Conditional 注解，仅在满足特定条件时应用，例如某个类位于类路径中，或者某个 Bean 尚未定义。

@AutoConfiguration
@ConditionalOnClass(DataSource.class)
@ConditionalOnMissingBean(DataSource.class)
public class DataSourceAutoConfiguration {
    @Bean
    public DataSource dataSource(DataSourceProperties props) {
        return DataSourceBuilder.create().build();
    }
}

Spring Boot Starter

Starter 是一组经过整理的依赖描述符。将 spring-boot-starter-web 添加到项目后，就会引入 Spring MVC、Tomcat、Jackson 及其自动配置，无需手动查找依赖。

// build.gradle:
dependencies {
    implementation "org.springframework.boot:spring-boot-starter-web"
    implementation "org.springframework.boot:spring-boot-starter-data-jpa"
    implementation "org.springframework.boot:spring-boot-starter-validation"
}

常用 Starter

主要的 Starter 包括：starter-web（REST + Tomcat）、starter-data-jpa（JPA + Hibernate）、starter-security、starter-test（JUnit + Mockito）和 starter-actuator（健康状态与指标）。

覆盖自动配置

定义一个相同类型的自有 @Bean，即可让它优先于自动配置的 Bean。@ConditionalOnMissingBean 可以确保只有在您的 Bean 不存在时，才创建自动配置的 Bean。

// Override auto-configured ObjectMapper:
@Configuration
public class JacksonConfig {
    @Bean
    public ObjectMapper objectMapper() {
        return new ObjectMapper()
            .disable(SerializationFeature.WRITE_DATES_AS_TIMESTAMPS)
            .registerModule(new JavaTimeModule());
    }
}

排除自动配置

您可以排除不需要的特定自动配置类。当某个 Starter 引入了您希望手动配置的内容时，这种方式非常有用。

@SpringBootApplication(exclude = {
    DataSourceAutoConfiguration.class,
    SecurityAutoConfiguration.class
})
public class MyApp { ... }

创建自己的 Starter

创建一个包含自动配置类的 Starter 模块，并将其注册到 META-INF/spring/....AutoConfiguration.imports 中。其他项目引入您的 Starter 后，就会自动获得您的 Bean。

// my-starter/META-INF/spring/org.springframework.boot.autoconfigure.AutoConfiguration.imports:
// com.example.MyLibraryAutoConfiguration

调试自动配置

使用 --debug 标志运行，或设置 logging.level.org.springframework.boot.autoconfigure=DEBUG，即可查看“CONDITIONS EVALUATION REPORT”，其中会列出应用或排除的自动配置以及相应原因。

java -jar myapp.jar --debug
# Or in application.properties:
# logging.level.org.springframework.boot.autoconfigure=DEBUG

Actuator /conditions 端点

启用 spring-boot-starter-actuator，并公开 /actuator/conditions 端点，即可在运行时查看自动配置评估报告，无需重启应用。

# application.properties:
management.endpoints.web.exposure.include=conditions
# Then:
curl http://localhost:8080/actuator/conditions

快速检查

哪个注解会使 Bean 仅在尚未定义相同类型的 Bean 时创建？

回顾

自动配置使用条件注解，根据类路径和现有 Bean 连接各个 Bean。Starter 会捆绑依赖和自动配置。您可以使用自有 Bean 覆盖默认配置，排除不需要的配置，并使用 --debug 进行调试。

常见问题解答

「自动配置与 Spring Boot 启动器」课时是免费的吗？

是的 — 「自动配置与 Spring Boot 启动器」的完整文本可在网页上免费阅读。要进行交互式练习（内置代码编辑器和全天候 AI 导师）并解锁 Java Academy 课程的其余内容，请升级到 CoddyKit PRO。 Java Academy 课程共包含 4 节课。

「自动配置与 Spring Boot 启动器」这节课中我会学到什么？

了解 Spring Boot 如何根据类路径依赖和条件注解自动配置 Bean 你通过在浏览器中直接运行的动手代码来练习 Java Academy，全天候 AI 导师会在你学习这节课的过程中回答你的问题。

学习 Java Academy 需要有经验吗？

无需任何先前经验。CoddyKit 上的 Java Academy 课程适合初学者到高级学习者，你可以从这里开始或从头开始，按照自己的节奏学习。这是第 1 节课，共 4 节。

「自动配置与 Spring Boot 启动器」课时需要多长时间？

大多数 CoddyKit 课程大约需要 5–10 分钟。每节课都很精短且互动，所以你能稳步进步，并在网页和应用中从离开的地方继续。

我能在这节 Java Academy 课中编写并运行代码吗？

能。每节 Java Academy 课都包含内置代码编辑器，你可以在浏览器中直接编写并运行真实代码，并获得即时 AI 反馈 — 无需本地设置。

此课程中的所有课时

← 返回 Java Academy