Spring Boot中@Async注解方法是否必须返回CompletableFuture？

@Async注解标记的方法不是必须以CompletableFuture作为返回类型，直接返回自定义类型（如你的ResponseDTO）是可行的，但两种返回类型的行为差异很大，需要根据业务需求选择：

1. 返回普通类型（如ResponseDTO）的情况 #

• 异步执行生效：Spring会将方法提交到你配置的threadPoolTaskExecutor线程池执行，调用方调用方法后会立即返回，不会等待方法执行完成。
• 无法获取有效返回结果：方法的执行在后台异步线程，调用方拿到的返回值是无效的（异步线程可能还未执行到return语句，甚至返回默认值/null）。
• 无法感知执行状态：调用方无法知晓异步方法是否执行完成、是否抛出异常，异常会被Spring默认的AsyncUncaughtExceptionHandler处理（通常是打印日志），调用方无法主动捕获。

比如你提供的示例代码，虽然标记了@Async，但调用方调用getCapa()时，根本拿不到第三方接口返回的真实ResponseDTO，因为此时异步线程可能还在调用第三方接口。

2. 返回CompletableFuture的情况 #

• 可控制异步流程：调用方可以通过CompletableFuture的API，用join()/get()等待执行完成并获取结果，用thenAccept()/thenApply()异步处理结果，用exceptionally()处理执行异常。
• 能完整获取执行状态和结果：这是需要获取异步方法返回值时的标准写法。

修正后的示例代码 #

@Async("threadPoolTaskExecutor")
public CompletableFuture<ResponseDTO> getCapa(final List<String> vins) {
    for (String vin : vins) {
        CapabilityDTO capabilityDTO = new CapabilityDTO();
        // 调用第三方接口
        Optional<ResponseDTO> response = thirdPartyClient.getInfo();
        // 处理业务逻辑...
        return CompletableFuture.completedFuture(response.get());
    }
    // 处理循环未匹配到数据的场景，返回默认结果
    return CompletableFuture.completedFuture(new ResponseDTO());
}

调用方示例 #

// 获取异步任务的Future对象
CompletableFuture<ResponseDTO> future = yourService.getCapa(vins);

// 方式1：同步等待结果（会阻塞当前线程）
ResponseDTO result = future.join();

// 方式2：异步处理结果（不阻塞当前线程）
future.thenAccept(result -> {
    // 处理返回的ResponseDTO
}).exceptionally(ex -> {
    // 处理异步执行中的异常
    log.error("异步调用失败", ex);
    return null;
});

总结 #

• 如果业务不需要获取异步方法的返回结果、也不需要感知执行状态，返回普通类型（甚至void）是可以的。
• 如果需要获取第三方接口的返回结果，或者需要处理异步执行的异常，必须返回CompletableFuture（或其子类/实现类）。

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