Spring Batch 默认会在上下文初始化时自动触发带有 @Bean 声明的 Job 实例（若未禁用），即使配置了 spring.batch.job.enabled=false 且未使用 CommandLineRunner，仍可能因 Bean 初始化副作用导致 SQL 执行。本文详解根本原因与可靠解决方案。
spring batch 默认会在上下文初始化时自动触发带有 `@bean` 声明的 `job` 实例（若未禁用），即使配置了 `spring.batch.job.enabled=false` 且未使用 `commandlinerunner`，仍可能因 bean 初始化副作用导致 sql 执行。本文详解根本原因与可靠解决方案。
在 Spring Boot + Spring Batch 项目中，作业自动执行的根本原因并非 spring.batch.job.enabled=false 失效，而是 @Bean 方法中直接调用了具有副作用的操作（如 jdbcTemplate.update(...)） —— 尤其是在 ItemProcessor 的 @Bean 定义中执行数据库写操作，这会导致 Spring 在容器启动阶段实例化该 Bean 时立即执行 SQL，与 Job 是否运行完全无关。
观察您的代码，问题核心在于：
@Bean
public ItemProcessor<..., ...> processor() {
String insertSql = "INSERT INTO MT_INSTRUMENT_TEMP_VAIBHAV (...)";
String updateSql = "UPDATE ...";
// ❌ 这些 jdbcTemplate.update() 在 Bean 创建时即执行！
jdbcTemplate.update(insertSql);
jdbcTemplate.update(updateSql);
// ...
return null; // 返回 null 导致后续 Step 执行失败，但副作用已发生
}✅ 正确做法：将数据操作逻辑从 @Bean 定义中移出，仅在 Job 实际执行时触发。 推荐采用以下组合策略：
1. 彻底禁用自动 Job 启动（基础防护）
确保 application.yml 中显式关闭自动执行：
spring:
batch:
job:
enabled: false # 必须为 false（默认 true）⚠️ 注意：此配置仅阻止 Spring Batch 自动查找并运行
JobBean，不阻止任何@Bean方法内的初始化逻辑执行。
2. 使用 @StepScope 隔离有副作用的组件
将 ItemProcessor（及其他含 jdbcTemplate 调用的组件）声明为 @StepScope，确保其仅在 Step 执行时创建和初始化，而非应用启动时：
@Bean
@StepScope
public ItemProcessor<InterestDateUpdationEntity, InterestDateUpdationEntity> processor(
JdbcTemplate jdbcTemplate) { // 通过参数注入，避免依赖提前解析
return new ItemProcessor<>() {
@Override
public InterestDateUpdationEntity process(InterestDateUpdationEntity item) throws Exception {
// ✅ 此处执行逻辑 —— 仅在 Step chunk 处理时调用
jdbcTemplate.update("INSERT INTO ...");
jdbcTemplate.update("UPDATE ...");
return item;
}
};
}? 关键点：
@StepScope+ 参数化依赖注入，可延迟 Bean 创建至 Job 运行期，并避免jdbcTemplate在上下文刷新阶段被误触发。
3. 移除 @Bean 中所有非声明性逻辑
禁止在 @Bean 方法体中执行业务 SQL、文件读写、HTTP 调用等副作用操作。@Bean 方法应只负责定义和组装组件，不负责执行。
4. （可选）显式禁用 JobRegistry 自动注册
若使用 JobBuilderFactory，添加 @ConditionalOnProperty("spring.batch.job.enabled") 双重保障：
@Bean
@ConditionalOnProperty(name = "spring.batch.job.enabled", havingValue = "true", matchIfMissing = false)
public Job runJob(Step step1, JobRepository jobRepository) {
return new JobBuilder("job", jobRepository)
.incrementer(new RunIdIncrementer())
.flow(step1)
.end()
.build();
}总结
-
spring.batch.job.enabled=false仅控制 Job 自动触发，不控制 Bean 初始化副作用； -
@Bean中执行jdbcTemplate.update()是反模式，必须重构到@StepScope组件或JobExecutionListener的beforeJob()中； - 您提到的
@StepScope解法完全正确——它让处理器真正“按需加载”，是解决此类问题的 Spring Batch 最佳实践； - 最终验证：启动应用后检查日志，确认
INSERT/UPDATE语句不再出现；仅当调用/api/job/run-job时才执行。
遵循以上原则，即可彻底杜绝 Spring Batch 作业在启动阶段的意外执行，确保批处理行为完全可控、可预测。
