java API接口如何异步

在 Java 里，“API 接口异步”通常有两种常见含义，下面分别说明，并给出最常用、最推荐的做法。

一、Controller 接口异步返回（Spring Boot 场景，最常用）

目标：请求进来后，后台用线程池异步处理，接口快速返回，不阻塞 Tomcat 线程。

✅ 推荐方式 1：Callable

@RestController
public class AsyncController {

    @GetMapping("/async")
    public Callable<String> async() {
        return () -> {
            Thread.sleep(2000); // 模拟耗时
            return "done";
        };
    }
}

✅ 特点：

• 不阻塞 Tomcat 线程
• Spring 自动使用异步线程池
• 简单、安全

✅ 推荐方式 2：CompletableFuture（更灵活）

@RestController
public class AsyncController {

    @GetMapping("/async2")
    public CompletableFuture<String> async2() {
        return CompletableFuture.supplyAsync(() -> {
            try {
                Thread.sleep(2000);
            } catch (InterruptedException e) {
                e.printStackTrace();
            }
            return "done";
        });
    }
}

✅ 适合：

• 多任务并行
• 组合异步结果

✅ 方式 3：@Async（业务层异步）

@Service
public class AsyncService {

    @Async
    public void doWork() {
        // 异步执行
    }
}

@SpringBootApplication
@EnableAsync
public class Application {}

⚠ 注意：

• @Async 方法必须通过 Spring Bean 调用
• 不能直接本类调用

二、接口“异步响应”（客户端不等待结果）

场景：下单后，接口立即返回“已受理”，后台慢慢处理。

方式 1：消息队列（最合理）

API → MQ → 消费服务

方式 2：任务 ID 轮询

{
  "taskId": "123",
  "status": "PROCESSING"
}

三、原生 Servlet 异步（了解即可）

@RequestMapping("/servlet-async")
public void async(HttpServletRequest req, HttpServletResponse resp) {
    AsyncContext ctx = req.startAsync();
    ctx.start(() -> {
        // 异步处理
        ctx.complete();
    });
}

⚠ 复杂度高，Spring 已封装得更好

四、常见误区

❌ new Thread(() -> {}).start()
（线程无法管理，生产环境禁止）

❌ 在 Controller 里 sleep
（仍然是同步阻塞）

五、总结建议

如果你愿意，可以告诉我：

• 用的是 Spring Boot 还是原生 Servlet
• 是 接口返回慢 还是 不想让用户等

我可以直接给你一整套可运行示例。