spring boot中rest接口异步响应的核心是将耗时任务剥离主线程并行执行，而非使controller方法异步；@async不可直接用于@getmapping，适合后台通知类场景，而completablefuture或webclient+mono.zip适用于需聚合多数据的并发调用。
Spring Boot 中 REST 接口实现多线程异步响应，核心不是让 Controller 方法本身“变异步”，而是把耗时子任务（如调用多个下游接口、查库、文件处理等）从主线程中剥离，用线程池并行执行，并安全聚合结果返回。直接在 @GetMapping 上加 @Async 是无效的——REST 接口方法必须同步返回响应体或 Mono/Flux，否则 HTTP 连接会提前关闭。
用 @Async + 自定义线程池做后台异步任务
适合场景：用户发起请求后无需等待结果，比如日志上报、邮件发送、消息通知、数据预热等。
- 主类或配置类加上 @EnableAsync
- 定义线程池 Bean，避免使用默认无限制的 SimpleAsyncTaskExecutor（易 OOM）
- Service 层方法标注 @Async("yourExecutor")，返回 void 或 CompletableFuture
- Controller 中调用该方法后立即返回成功提示，不等待执行完成
例如：用户注册后异步发欢迎邮件，Controller 返回 “注册成功” 即可，邮件发送由独立线程处理。
用 CompletableFuture 并行调用多个下游 REST 接口
适合场景：一个接口需聚合多个外部系统数据（如订单页拉取库存、价格、物流），要求快速响应且结果必须全部返回。
- 用 WebClient（非阻塞）替代 RestTemplate（阻塞），避免线程浪费
- 每个下游调用封装为 CompletableFuture.supplyAsync(..., executor)，指定共享线程池
- 用 CompletableFuture.allOf() 等待全部完成，再用 thenApply 合并结果
- 注意异常处理：每个 future 要 .exceptionally() 或统一 try-catch，防止一个失败导致整体失败
示例中调用 hello1（5s）和 hello2（8s），并行后总耗时约 8 秒，而非串行的 13 秒。
用 WebClient + Mono.zip 实现响应式并发（推荐新项目）
适合高并发、低延迟场景，天然支持非阻塞、背压、超时控制，资源利用率更高。
- 注入 WebClient Bean，配置好 base url 和超时
- 每个下游请求写成 Mono
，用 Mono.zip(a, b, c) 并发触发 - zip 会等待所有 Mono 完成，自动打包结果元组，也可用 zipWith 两两组合
- 链式调用 .onErrorResume() 处理单点失败，保障整体可用性
相比 CompletableFuture，代码更简洁，错误传播更自然，且与 Spring WebFlux 兼容无缝。
关键避坑点
避免常见误用导致线程阻塞或数据错乱：
- 不要在 @Async 方法里用 Thread.sleep() 或阻塞 I/O —— 会吃掉线程池资源，建议改用 WebClient + timeout 或 Mono.delay
- 别用 parallelStream().forEach() 直接操作 ArrayList —— 改用 ConcurrentHashMap 或 synchronizedList + set(index, obj)
- @Async 方法不能被本类内其他方法直接调用 —— 因代理失效，需通过注入的 Service 实例调用
- 异步方法抛异常默认丢失 —— 若返回 CompletableFuture，用 .handle() 捕获；若 void，配 AsyncUncaughtExceptionHandler
