Spring Batch 5+Cucumber集成测试报错：BATCH_JOB_INSTANCE表不存在

核心原因 #

Spring Batch 5 搭配 Spring Boot 3.x 版本时，默认不再自动创建Batch核心表，这是框架的默认行为变更，直接导致测试时因找不到BATCH_JOB_INSTANCE等表抛出异常。

方案一：通过配置自动生成表（推荐） #

你可以通过Spring Boot配置+Cucumber测试上下文配置，让框架自动完成Batch表的创建：

1. 配置测试环境配置文件
   在application-test.properties（或application-test.yml）中添加以下配置：

   # 开启Batch表初始化（仅测试环境使用）
   spring.batch.jdbc.initialize-schema=always
   # H2数据库基础配置（根据你的测试环境调整）
   spring.datasource.url=jdbc:h2:mem:testdb
   spring.datasource.driverClassName=org.h2.Driver
   spring.datasource.username=sa
   spring.datasource.password=
   

   注意：always仅适合测试场景，生产环境请设置为never或embedded（仅嵌入式数据库自动初始化）。

2. 配置Cucumber测试上下文
   创建一个Cucumber配置类，让测试加载Spring Boot上下文以读取上述配置：

   import org.springframework.boot.test.context.SpringBootTest;
   import io.cucumber.spring.CucumberContextConfiguration;
   
   @CucumberContextConfiguration
   @SpringBootTest
   public class CucumberSpringConfig {
   }
   

   这个类会让Cucumber测试复用Spring Boot的应用上下文，自动触发Batch的表初始化逻辑。

方案二：手动执行建表脚本 #

如果自动配置无法生效，可手动执行Spring Batch官方提供的建表脚本：

1. 获取H2建表脚本
   Spring Batch的jar包中自带H2数据库的建表脚本，路径为org/springframework/batch/core/schema-h2.sql，将其复制到测试资源目录（如src/test/resources）。

2. 在Cucumber测试中执行脚本
   在你的Cucumber步骤类上添加@Sql注解，指定测试前执行脚本：

   import org.springframework.test.context.jdbc.Sql;
   import io.cucumber.java.en.Given;
   
   @Sql(scripts = "classpath:schema-h2.sql", executionPhase = Sql.ExecutionPhase.BEFORE_TEST_METHOD)
   public class BatchStepDefinitions {
       // 你的测试步骤定义
   }
   

   这样每次测试方法执行前，都会先完成表的创建，确保依赖的表存在。

注意事项 #

• H2内存数据库的测试数据会在测试结束后自动清空，无需手动清理。
• 如果使用持久化数据库，需注意重复执行脚本可能触发"表已存在"错误，可在脚本中添加IF NOT EXISTS逻辑，或调整executionPhase=BEFORE_TEST_CLASS让脚本仅执行一次。

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