自动配置

Spring Boot 自动配置尝试根据您添加的 jar 依赖项自动配置您的 Spring 应用程序。例如,如果 HSQLDB 位于您的类路径中,并且您没有手动配置任何数据库连接 Bean,那么 Spring Boot 会自动配置一个内存数据库。

您需要通过在您的一个 @Configuration 类中添加 @EnableAutoConfiguration@SpringBootApplication 注解来选择加入自动配置。

您应该只添加一个 @SpringBootApplication@EnableAutoConfiguration 注解。我们通常建议您只在您的主要 @Configuration 类中添加一个或另一个。

逐步替换自动配置

自动配置是非侵入性的。在任何时候,您都可以开始定义自己的配置来替换自动配置的特定部分。例如,如果您添加了自己的 DataSource Bean,默认的嵌入式数据库支持就会退回。

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

禁用特定自动配置类

如果您发现应用了您不想要的特定自动配置类,可以使用@SpringBootApplicationexclude属性来禁用它们,如下例所示

  • Java

  • Kotlin

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

如果该类不在类路径上,您可以使用该注释的excludeName属性并指定完全限定名。如果您更喜欢使用@EnableAutoConfiguration而不是@SpringBootApplicationexcludeexcludeName也可用。最后,您还可以使用spring.autoconfigure.exclude属性来控制要排除的自动配置类列表。

您可以在注释级别和使用属性时定义排除项。
即使自动配置类是public,但该类中唯一被视为公共 API 的方面是该类的名称,该名称可用于禁用自动配置。这些类的实际内容,例如嵌套配置类或 bean 方法,仅供内部使用,我们不建议直接使用它们。

自动配置包

自动配置包是各种自动配置功能在默认情况下扫描实体和 Spring Data 存储库等内容时查找的包。@EnableAutoConfiguration注释(直接或通过其在@SpringBootApplication上的存在)确定默认的自动配置包。可以使用@AutoConfigurationPackage注释配置其他包。