Spring Boot 2.7.10升级3.1.2时排除DataSourceAutoConfiguration失效求助

我们正将Spring Boot从2.7.10版本升级至3.1.2版本，启动其中一个模块时出现“必须配置数据源”的错误。原本在2.7.10中正常运行的代码，通过@SpringBootApplication注解的exclude属性排除DataSourceAutoConfiguration.class似乎不再生效。

原代码如下：

package nl.the.application;

import org.springframework.batch.core.configuration.annotation.EnableBatchProcessing;
import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.boot.autoconfigure.jdbc.DataSourceAutoConfiguration;
import org.springframework.boot.context.properties.ConfigurationPropertiesScan;
import org.springframework.boot.web.servlet.support.SpringBootServletInitializer;
import org.springframework.data.mongodb.config.EnableMongoAuditing;
import org.springframework.scheduling.annotation.EnableScheduling;

@ConfigurationPropertiesScan
@SpringBootApplication(exclude = {DataSourceAutoConfiguration.class})
@EnableScheduling
@EnableBatchProcessing
@EnableMongoAuditing
public class TheClientApplication extends SpringBootServletInitializer {

    public static void main(final String[] args) {
        SpringApplication.run(TheClientApplication.class, args);
    }
}

启动应用时的错误日志：

***************************
APPLICATION FAILED TO START
***************************

Description:

A component required a bean named 'dataSource' that could not be found.


Action:

Consider defining a bean named 'dataSource' in your configuration.


Process finished with exit code 1

原因与修复方案 #

这个问题是Spring Boot 3.x版本的已知调整：@EnableBatchProcessing默认会强制要求数据源存在——即便你排除了DataSourceAutoConfiguration。在2.7.x版本中，Spring Batch允许无数据源的配置，但3.x版本调整了逻辑，启用批处理时自动配置会尝试创建数据源相关依赖。

以下是几种可行的修复方式：

• 方式一：排除Batch的数据源自动配置类
  在@SpringBootApplication的exclude列表中新增BatchDataSourceAutoConfiguration.class，保留原有排除项：

  @SpringBootApplication(exclude = {
      DataSourceAutoConfiguration.class,
      org.springframework.boot.autoconfigure.batch.BatchDataSourceAutoConfiguration.class
  })
  

  此方法可直接阻止Spring Batch自动配置数据源相关bean。

• 方式二：配置内存数据源（适用于无需持久化批处理元数据的场景）
  如果你的批处理不需要持久化元数据，可在配置文件（application.properties/application.yml）中添加内存数据源配置：

  spring.batch.jdbc.initialize-schema=always
  spring.datasource.url=jdbc:h2:mem:batchdb;DB_CLOSE_DELAY=-1
  spring.datasource.driver-class-name=org.h2.Driver
  spring.datasource.username=sa
  spring.datasource.password=
  

  若项目未引入H2依赖，需同步添加对应依赖。

• 方式三：禁用Spring Batch自动配置
  若你不需要Spring Batch的自动配置逻辑，可直接排除BatchAutoConfiguration.class：

  @SpringBootApplication(exclude = {
      DataSourceAutoConfiguration.class,
      org.springframework.boot.autoconfigure.batch.BatchAutoConfiguration.class
  })
  

  此方式需手动配置所有Batch相关bean，适合自定义程度较高的场景。

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