Spring Batch 6中StepExecutionListener执行顺序异常问题咨询

我的项目使用Spring Batch 6.0.3版本，为步骤配置了两个StepExecutionListener，代码如下：

@Bean(name = "myStep")
public Step myStep(JobRepository jobRepository, PlatformTransactionManager transactionManager,
        @Qualifier("myFirstListener") MyFirstListener myFirstListener,
        @Qualifier("mySecondListener") MySecondListener mySecondListener,
        @Qualifier("myTasklet") MyTasklet myTasklet) {
    return new StepBuilder("myStep", jobRepository) //
            // 即使作业重启且之前状态为COMPLETED，步骤仍会运行
            .allowStartIfComplete(true) //
            .tasklet(myTasklet, transactionManager) //
            .listener(myFirstListener) //
            .listener(mySecondListener) //
            .build();
}

我在两个监听器的afterStep()方法中添加日志后发现，第二个添加的监听器反而先执行，日志输出如下：

08:33:54.958 [main] INFO  c.a.o.b.m.MySecondListener [requestId:BATCH-7617dc68-4014-4020-9dff-d9a07c594d09] - MySecondListener.afterStep()
08:33:54.959 [main] INFO  c.a.o.b.l.MyFirstListener [requestId:BATCH-7617dc68-4014-4020-9dff-d9a07c594d09] - Step myStep ended with status=COMPLETED, exitStatus=COMPLETED, readCount=1, filterCount=0, writeCount=1, readSkipCount=0, writeSkipCount=0, processSkipCount=0, commitCount=1, rollbackCount=0.

我原本以为afterStep()方法的调用顺序会与监听器的添加顺序一致，这种不符合预期的情况是否正常？这会给业务逻辑带来困扰（比如异常处理监听器和结果日志监听器的顺序控制）。

回答 #

这种情况是正常的，属于Spring Batch的设计逻辑：

• 对于StepExecutionListener的beforeStep方法，会按照监听器的添加顺序依次执行；
• 而afterStep方法则会按照添加顺序的逆序执行。

这种设计类似过滤器链的处理逻辑：如果先添加的监听器在beforeStep中做了资源初始化或前置处理，那么在afterStep中应该最后执行清理/后置处理，避免依赖资源被提前释放。

如果需要严格控制afterStep的执行顺序，有两种可行方案：

1. 调整监听器的添加顺序 #

如果希望某个监听器的afterStep先执行，就将它后添加到步骤中。比如你希望MyFirstListener的afterStep先执行，就调整代码中的添加顺序：

.listener(mySecondListener) // 先添加第二个
.listener(myFirstListener)  // 后添加第一个

这样afterStep会先执行MyFirstListener，再执行MySecondListener。

2. 使用Ordered接口或@Order注解给监听器指定优先级 #

让监听器实现Ordered接口，或者直接添加@Order注解指定顺序值（值越小优先级越高）：

• 对于beforeStep：优先级高（值小）的监听器先执行；
• 对于afterStep：优先级低（值大）的监听器先执行。

示例：

@Order(2)
public class MyFirstListener implements StepExecutionListener {
    // ...
}

@Order(1)
public class MySecondListener implements StepExecutionListener {
    // ...
}

此时beforeStep会先执行MySecondListener（Order=1），再执行MyFirstListener（Order=2）；而afterStep会先执行MyFirstListener（Order=2，值更大），再执行MySecondListener（Order=1）。

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