Spring Boot 3中Spring Batch Schema自动初始化配置无效问题

原因分析 #

Spring Boot 3.0（对应Spring Batch 5.x）对Spring Batch的schema初始化逻辑做了关键调整，直接导致原配置失效：

1. 配置行为变更：spring.batch.jdbc.initialize-schema属性在Spring Boot 3.x中已被标记为弃用，且默认仅对**嵌入式数据库（如H2）**生效，非嵌入式数据库（如你使用的PostgreSQL）即使设置为always，也不会触发自动初始化。
2. Spring Batch 5.x机制调整：Spring Batch 5.x移除了旧版本中无条件执行schema初始化的逻辑，转而更倾向于让开发者通过数据库迁移工具管理schema，或显式配置触发初始化。

解决办法 #

办法1：显式指定schema脚本并启用初始化 #

在application.yml中添加以下配置，强制触发PostgreSQL的schema初始化：

spring:
  batch:
    jdbc:
      initialize-schema: always
      schema: classpath:org/springframework/batch/core/schema-postgresql.sql

说明：schema-postgresql.sql是Spring Batch内置的PostgreSQL schema脚本，位于Spring Batch核心包的org/springframework/batch/core/路径下，直接通过classpath引用即可。

办法2：自定义初始化Bean #

如果上述配置不生效，可以手动创建DataSourceInitializer Bean来执行schema脚本：

import org.springframework.batch.core.configuration.annotation.EnableBatchProcessing;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import org.springframework.core.io.ClassPathResource;
import org.springframework.jdbc.datasource.init.DataSourceInitializer;
import org.springframework.jdbc.datasource.init.ResourceDatabasePopulator;

import javax.sql.DataSource;

@Configuration
@EnableBatchProcessing
public class BatchConfig {

    @Bean
    public DataSourceInitializer batchDataSourceInitializer(DataSource dataSource) {
        ResourceDatabasePopulator populator = new ResourceDatabasePopulator();
        populator.addScript(new ClassPathResource("org/springframework/batch/core/schema-postgresql.sql"));
        populator.setContinueOnError(true); // 避免表已存在时抛出异常

        DataSourceInitializer initializer = new DataSourceInitializer();
        initializer.setDataSource(dataSource);
        initializer.setDatabasePopulator(populator);
        return initializer;
    }
}

办法3：使用数据库迁移工具（推荐生产环境） #

对于生产环境，Spring Boot官方推荐使用Flyway或Liquibase来管理数据库schema版本，避免手动初始化的风险：

• 添加Flyway依赖到pom.xml（Maven）：

<dependency>
    <groupId>org.flywaydb</groupId>
    <artifactId>flyway-core</artifactId>
</dependency>

• 将Spring Batch的schema-postgresql.sql复制到src/main/resources/db/migration目录下，重命名为V1__create_batch_tables.sql，Flyway会在应用启动时自动执行该脚本。

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