对于最新的稳定版本，请使用 Spring Boot 3.4.0！spring-doc.cn

自动配置

Spring Boot 自动配置会尝试根据您添加的 jar 依赖项自动配置 Spring 应用程序。例如，如果在你的 Classpath 上，并且你没有手动配置任何数据库连接 bean，那么 Spring Boot 会自动配置内存数据库。HSQLDBspring-doc.cn

您需要通过将 @EnableAutoConfiguration 或 @SpringBootApplication 注解添加到其中一个 @Configuration 类来选择自动配置。spring-doc.cn

您应该只添加一个 @SpringBootApplication 或 @EnableAutoConfiguration 注释。我们通常建议您仅将其中一个添加到主@Configuration类中。

逐步替换自动配置

自动配置是非侵入性的。您可以随时开始定义自己的配置以替换自动配置的特定部分。例如，如果你添加自己的DataSource bean，则默认的嵌入式数据库支持将退出。spring-doc.cn

如果您需要了解当前正在应用的自动配置以及原因，请使用开关启动您的应用程序。这样做会为选定的核心记录器启用调试日志，并将条件报告记录到控制台。--debugspring-doc.cn

禁用特定的自动配置类

如果您发现正在应用不需要的特定自动配置类，则可以使用 @SpringBootApplication 的 exclude 属性来禁用它们，如以下示例所示：spring-doc.cn

Javaspring-doc.cn
Kotlinspring-doc.cn

import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.boot.autoconfigure.jdbc.DataSourceAutoConfiguration;

@SpringBootApplication(exclude = { DataSourceAutoConfiguration.class })
public class MyApplication {

}

import org.springframework.boot.autoconfigure.SpringBootApplication
import org.springframework.boot.autoconfigure.jdbc.DataSourceAutoConfiguration

@SpringBootApplication(exclude = [DataSourceAutoConfiguration::class])
class MyApplication

如果类不在 Classpath 上，则可以使用 Comments 的属性并指定完全限定名称。如果您更喜欢使用 @EnableAutoConfiguration 而不是 @SpringBootApplication，并且也是可用的。最后，您还可以使用 property 控制要排除的自动配置类的列表。excludeNameexcludeexcludeNamespring.autoconfigure.excludespring-doc.cn

您可以在注释级别定义排除项，也可以使用 property 定义排除项。

即使自动配置类是，类中被视为公共 API 的唯一方面是可用于禁用自动配置的类的名称。这些类的实际内容（例如嵌套配置类或 bean 方法）仅供内部使用，我们不建议直接使用它们。public

自动配置软件包

自动配置包是各种自动配置的功能在扫描实体和 Spring Data 存储库等内容时默认查找的包。 @EnableAutoConfiguration 注解（直接或通过它在 @SpringBootApplication 上的存在）确定默认的自动配置包。可以使用 @AutoConfigurationPackage 注释配置其他包。spring-doc.cn