用CompletableFuture异步聚合订单详情，需并行调用用户、商品、物流等独立服务，allOf监听完成后再取值；用handle统一兜底异常；关键字段强依赖可抛定制异常；最终一次性构建DTO；必须指定IO专用线程池避免阻塞。
电商系统中，订单详情通常需要聚合多个服务的数据：用户信息、商品信息、物流状态、优惠券使用情况等。用 CompletableFuture 实现异步聚合，核心是**并行发起多个独立查询、避免阻塞等待、统一处理结果或异常**，从而显著降低接口响应时间。
并行拉取多源数据，用 allOf 汇总完成信号
订单详情依赖的服务（如用户服务、商品服务、物流服务）相互独立，适合并发调用。不要用 join() 逐个等待，而是用 CompletableFuture.allOf() 监听全部完成，再统一收集结果：
- 为每个服务调用创建一个
CompletableFuture<T>，例如CompletableFuture<User> userFut = userService.findByIdAsync(order.getUserId()); - 把所有 future 放入数组，调用
allOf(futures...)得到一个CompletableFuture<Void>，它只表示“全部完成”，不携带结果 - 紧接着用
thenApply或thenCompose配合getNow(null)或join()安全提取各 future 结果（此时已确定完成，不会阻塞）
优雅处理单点失败：用 exceptionally 或 handle 统一兜底
某个服务超时或报错不应导致整个订单详情返回失败。推荐用 handle() —— 它无论成功或异常都会执行，可返回默认值或空对象：
deep-java-review
下载
Java项目代码review工具。分析Git变更+完整调用链路上下文，推断业务需求，进行多维度评分和分类汇总，生成完整PRD文档。包含细粒度Java代码审查清单（Null安全、异常处理、Streams、并发、equals/hashCode、资源管理、API设计、性能、MyBatis/ORM、事务边界、SQL/DD...
-
productFut.handle((product, ex) -> ex == null ? product : Product.empty())，保证后续聚合逻辑不因空指针中断 - 避免在
thenApply中直接调用get()，这会破坏异步性；异常应提前转为业务可识别的状态（如LogisticsStatus.UNKNOWN） - 对关键字段（如用户信息）可设强依赖，用
exceptionally()抛出定制异常，由上层统一降级或告警
组合结果构建订单详情 DTO，避免中间对象膨胀
不要在每个 future 里就组装完整订单对象，而应在最终阶段一次性构建，减少重复对象创建和 GC 压力：
立即学习“Java免费学习笔记（深入）”；
- 定义清晰的聚合函数，例如
OrderDetail buildOrderDetail(User u, List<Item> items, Logistics l, Coupon c) - 用
thenCombine两两合并（适合链式依赖），但多路聚合更推荐allOf + thenApply+ 手动取值方式，逻辑更直观可控 - 对列表类数据（如订单项），确保远程服务已做分页/过滤，避免 CompletableFuture 内部再做流式处理影响性能
线程与资源控制：指定自定义线程池，禁用 ForkJoinPool.commonPool()
电商高峰期大量订单聚合会压垮公共线程池。必须显式传入专用于 I/O 的线程池：
- 创建固定大小的线程池：
new ThreadPoolExecutor(20, 50, 60L, TimeUnit.SECONDS, new LinkedBlockingQueue(1000)) - 所有异步操作都通过
supplyAsync(supplier, executor)或thenApplyAsync(fn, executor)指定该池 - 避免使用
thenApply（默认用 commonPool），尤其当任务含数据库/HTTP 调用时，容易引发线程饥饿
