Spring Boot 2.7迁移至3.1.4时自动配置排除失效问题求助

核心原因分析 #

Spring Boot 3.x对自动配置体系做了重构：

• 原HibernateJpaAutoConfiguration的职责被整合到JpaAutoConfiguration中，旧的排除项不再生效
• 配置文件中spring.autoconfigure.exclude的加载优先级、生效范围在3.x中有调整
• @Transactional注解会触发Spring自动寻找PlatformTransactionManager，若未完全排除DB自动配置，会加载真实数据源的事务管理器

具体修复步骤 #

1. 修正自动配置排除项

将原bootstrap-stubdb.properties中的排除配置替换为Spring Boot 3.x兼容的项：

spring.autoconfigure.exclude=org.springframework.boot.autoconfigure.jdbc.DataSourceAutoConfiguration,org.springframework.boot.autoconfigure.orm.jpa.JpaAutoConfiguration,org.springframework.boot.autoconfigure.transaction.TransactionAutoConfiguration

说明：

• 用JpaAutoConfiguration替代旧的HibernateJpaAutoConfiguration
• 新增TransactionAutoConfiguration彻底排除事务相关自动配置

2. 改用application配置文件替代bootstrap

Spring Boot 3.x对bootstrap配置的支持默认关闭（未引入Spring Cloud Starter Bootstrap时），将bootstrap-stubdb.properties重命名为application-stubdb.properties，确保配置能被正确加载。

3. 强化Stub配置的隔离性

在StubConfiguration类中添加条件注解，确保仅在stubdb激活时生效，且覆盖真实DAO的Bean：

@Configuration
@Profile("stubdb")
// 确保当前配置优先加载，避免真实DAO被实例化
@AutoConfigureBefore(JpaAutoConfiguration.class)
public class StubConfiguration {

    @Bean
    @Primary // 标记为首选Bean，确保Service注入的是Stub实现
    public SubscriberContractDao subscriberContractDao() {
        return new SubscriberContractStubDao();
    }

    // 为@Transactional测试提供空事务管理器，避免触发真实DB事务
    @Bean
    public PlatformTransactionManager transactionManager() {
        return new ResourcelessTransactionManager();
    }
}

说明：ResourcelessTransactionManager是Spring提供的无资源事务管理器，适合Stub场景下的事务注解处理。

4. 调整测试类的注解配置

在测试类上显式指定自动配置排除，避免配置文件的优先级问题：

@SpringBootTest
@ActiveProfiles({"stubdb", "DEV"})
@AutoConfigureMockMvc
// 显式排除DB相关自动配置，优先级高于配置文件
@EnableAutoConfiguration(exclude = {
    DataSourceAutoConfiguration.class,
    JpaAutoConfiguration.class,
    TransactionAutoConfiguration.class
})
public class SubscriberContractControllerTest {
    // 测试逻辑...
}

5. 清理DEV profile中的冗余配置

检查DEV profile的配置文件，确保当stubdb激活时，不会加载DB连接配置（可通过@ConditionalOnMissingProfile("stubdb")在配置类中控制）。

验证要点 #

• 启动测试时，查看日志确认SubscriberContractStubDao被实例化，无HikariPool、EntityManagerFactory相关的初始化日志
• 带@Transactional的测试不再尝试连接真实DB，事务由ResourcelessTransactionManager处理

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