Spring Boot中能否在自定义自动配置类中禁用其他自动配置类？

要实现依赖你的库的项目零额外配置就能禁用DataSourceAutoConfiguration和HibernateJpaAutoConfiguration，你需要利用Spring Boot自动配置的加载优先级和专门的排除配置类，避开之前遇到的循环依赖问题。

为什么你之前的尝试失败了？ #

• 使用@EnableAutoConfiguration(exclude=...)在业务配置类上：这个注解会触发全局自动配置扫描，而你的业务配置类本身又在自动配置列表中，直接导致循环导入的IllegalStateException。
• 使用@ImportAutoConfiguration(exclude=...)：这个注解的exclude属性只针对你显式导入的自动配置类，无法全局排除Spring Boot默认的自动配置，所以没有效果。

正确的实现步骤 #

1. 创建专门的排除配置类

新建一个无业务逻辑的空配置类，仅用于排除不需要的默认自动配置，确保它的优先级最高：

import org.springframework.boot.autoconfigure.EnableAutoConfiguration;
import org.springframework.boot.autoconfigure.jdbc.DataSourceAutoConfiguration;
import org.springframework.boot.autoconfigure.orm.jpa.HibernateJpaAutoConfiguration;
import org.springframework.context.annotation.Configuration;
import org.springframework.core.Ordered;
import org.springframework.core.annotation.Order;

@Configuration
@Order(Ordered.HIGHEST_PRECEDENCE) // 确保最先被加载
@EnableAutoConfiguration(exclude = {
    DataSourceAutoConfiguration.class,
    HibernateJpaAutoConfiguration.class
})
public class DisableDefaultDataConfig {
    // 空类，仅承担排除配置的作用
}

2. 注册自动配置类

根据你使用的Spring Boot版本，将这个排除配置类和你的业务自动配置类注册到自动配置列表中：

如果你用Spring Boot 2.7+（推荐方式）

在库的src/main/resources/META-INF/spring/目录下创建org.springframework.boot.autoconfigure.AutoConfiguration.imports文件，内容如下：

com.yourpackage.DisableDefaultDataConfig
com.yourpackage.YourActualDataAccessAutoConfiguration

注意：把com.yourpackage替换成你实际的包路径，YourActualDataAccessAutoConfiguration是你库中负责注入仓库等业务逻辑的自动配置类。

如果你用Spring Boot 2.6及以下

在src/main/resources/META-INF/spring.factories文件中添加：

org.springframework.boot.autoconfigure.EnableAutoConfiguration=\
com.yourpackage.DisableDefaultDataConfig,\
com.yourpackage.YourActualDataAccessAutoConfiguration

3. 验证效果

当依赖你的库的Spring Boot项目启动时，开启debug级别日志，你会看到类似以下的输出，确认目标配置已被排除：

Excluding auto-configuration class org.springframework.boot.autoconfigure.jdbc.DataSourceAutoConfiguration
Excluding auto-configuration class org.springframework.boot.autoconfigure.orm.jpa.HibernateJpaAutoConfiguration

核心原理 #

• 优先级最高的DisableDefaultDataConfig会被最先加载，它通过@EnableAutoConfiguration(exclude=...)全局排除了默认的数据源和JPA配置。
• 之后Spring Boot才会加载你的业务自动配置类，此时默认配置已经被禁用，不会和你的库的配置产生冲突。
• 依赖项目无需任何额外配置，只需引入你的库依赖，Spring Boot就会自动完成所有配置。

内容的提问来源于stack exchange，提问作者Steve