CompletableFuture 没有 copy() 方法，JDK 8–21 官方 API 中从未提供；所谓“复制”实为误解，正确做法是对每条分支单独使用 orTimeout() 或 completeOnTimeout() 实现独立超时控制。
CompletableFuture 没有 copy() 方法——这是个常见误解，直接用会编译失败。
为什么找不到 copy()？Java 8–21 的 CompletableFuture 确实不提供该方法
有人在源码里翻不到 copy()，或在 IDE 里敲出 cf.copy() 报红，不是环境问题，是它根本不存在。JDK 官方 API 中从无此方法；部分文章混淆了第三方库（如 Vavr）的 Future 或自定义封装工具类的行为。
-
CompletableFuture是不可变状态机：内部用栈式链表维护依赖，thenApply、thenCompose等返回的是新实例，但不是“拷贝”，而是新构建的、持有前序结果引用的独立对象 - 所谓“复制任务”实际要解决的是：同一个原始异步操作，被多个下游逻辑消费，且各自需要独立超时控制
- 强行加
copy()封装容易掩盖线程安全风险——比如共享AtomicInteger计数器却没考虑并发递减
替代方案：用 orTimeout() + exceptionally() 实现单链路熔断
真正可靠的做法，是在每个需要超时保护的 CompletableFuture 节点上单独设限，而不是幻想“复制一份再熔断”。orTimeout() 是 JDK 9+ 引入的原生支持，语义清晰、无额外依赖。
-
orTimeout(3, TimeUnit.SECONDS)会在超时后以TimeoutException完成该实例，触发后续exceptionally()或handle() - 注意：它只对“未完成”的实例生效；如果上游已
complete()或异常结束，orTimeout()不起作用 - 不要链式调用
orTimeout().orTimeout()——第二个无效，因为第一个已返回新实例，且可能已完成 - 示例：
CompletableFuture<String> task = CompletableFuture.supplyAsync(() -> { try { Thread.sleep(5000); } catch (InterruptedException e) {} return "done"; }).orTimeout(2, TimeUnit.SECONDS) .exceptionally(t -> t instanceof TimeoutException ? "fallback" : null);
多分支并行超时：用 CompletableFuture.allOf() + 单独 orTimeout() 组合
当一个源头任务需被 A/B/C 三个下游分别处理，且每个都要独立超时（比如 A 最多 1s、B 最多 3s、C 最多 500ms），不能共用一个 orTimeout()，必须为每条分支创建隔离的超时控制。
- 先用
supplyAsync()触发原始计算，得到基础CompletableFuture<t></t> - 再用
thenApplyAsync()派生各分支，并立刻对每个分支调用orTimeout() - 最后用
CompletableFuture.allOf(f1, f2, f3)汇总，注意allOf()返回CompletableFuture<void></void>，需手动join()或thenCombine()取值 - 关键陷阱：避免直接
cf.thenApply(...).orTimeout()后再传给allOf()——若某分支超时，其CompletableFuture会以异常完成，allOf()仍会等它“完成”（即等到异常状态），不会跳过
更健壮的熔断：配合 completeOnTimeout() 避免阻塞等待
orTimeout() 抛异常，适合需要区分“超时”和“业务异常”的场景；但若只想兜底返回默认值、且不希望下游还要写 exceptionally()，completeOnTimeout() 更直接。
-
completeOnTimeout("default", 1, TimeUnit.SECONDS)在超时后以指定值完成，不抛异常，下游可直接join() - 它和
orTimeout()互斥：对同一实例连续调用，后者会覆盖前者（因都修改内部 state） - 注意线程安全：若原始任务已开始执行，
completeOnTimeout()不会中断它，只是“抢先完成”；后台线程仍在跑，可能造成资源泄漏或重复提交 - 真正需要中断执行，得靠任务自身响应
Thread.interrupt()，例如supplyAsync(() -> { if (Thread.currentThread().isInterrupted()) throw new RuntimeException(); ... })
超时熔断的关键不在“复制”，而在“分治”：每个异步环节明确自己的 SLO，用 orTimeout() 或 completeOnTimeout() 做守门人。试图用不存在的 copy() 统一管控，反而会让超时边界模糊、异常传播难追踪。
