Spring Boot中如何上报@Async异步方法的执行状态？

算力阿峰

2026-7-15

Spring Boot异步任务状态上报解决方案

你可以通过try-catch-finally结构精准控制状态上报时机，同时保证异常场景下状态也能正确更新：

调整后的异步方法代码

@Async
public void longProcess() {
    try {
        reportService.report("STARTED");
        // 标记任务进入执行阶段
        reportService.report("PROCESSING");
        // 触发长时核心任务
        globalService.globalCall();
        // 任务执行完成，标记结束状态
        reportService.report("FINISHED");
    } catch (Exception e) {
        // 捕获任务执行过程中的所有异常，标记失败状态
        reportService.report("FAILED");
        // 抛出异常以便Spring追踪（可选，根据业务需求决定是否保留）
        throw new RuntimeException("长时任务执行失败", e);
    }
}

关键逻辑说明

STARTED：任务刚启动时上报，标记任务已初始化
PROCESSING：在核心任务globalCall()执行前上报，明确任务进入正式处理阶段
FINISHED：globalCall()执行完成后上报，标记任务正常结束
FAILED：通过catch块捕获所有异常，避免状态停留在PROCESSING，保证状态闭环

可选：更细粒度的状态上报

如果需要追踪globalCall()内部每个子任务的状态，可以修改globalCall()方法，在每个服务调用前后添加状态上报：

public void globalCall() {
    reportService.report("PROCESSING_SERVICE_ONE");
    serviceOne.doSomething();
    
    reportService.report("PROCESSING_SERVICE_TWO");
    serviceTwo.doSomething();
    
    reportService.report("PROCESSING_SERVICE_THREE");
    serviceThree.doSomething();
}