CompletableFuture 本身不直接支持超时，但可通过 orTimeout（Java 9+）或 applyToEither + delayedExecutor（Java 8 兼容）实现；超时仅终止 Future 完成，不中断底层任务执行，需配合 exceptionally 处理异常，cancel(true) 对非中断敏感操作无效。
CompletableFuture 本身不直接支持超时，但可以通过 applyToEither 或 orTimeout（Java 9+）配合 delayedExecutor 实现可靠超时控制。
使用 orTimeout（推荐，Java 9+）
最简洁的方式是调用 orTimeout，它会在指定时间后抛出 TimeoutException：
- 调用后返回原 CompletableFuture 的增强版本，超时自动失败
- 必须配合
exceptionally或handle捕获超时异常，否则会中断链式调用 - 注意：超时仅作用于该 CompletableFuture 的完成过程，不中断底层线程或任务执行
CompletableFuture<String> future = CompletableFuture.supplyAsync(() -> {
try { Thread.sleep(3000); } catch (InterruptedException e) { }
return "done";
}).orTimeout(2, TimeUnit.SECONDS)
.exceptionally(ex -> ex instanceof TimeoutException ? "timeout" : ex.getMessage());
手动构造超时 Future（兼容 Java 8）
用 CompletableFuture.anyOf 或 applyToEither 合并一个延迟的“超时 Future”：
Alibabacloud Sdk Client Initialization For Java
下载
在 Java 中初始化和管理阿里云 SDK客户端。包括单例模式、线程安全、endpoint 与 region 配置、VPC 终端节点、同步与异步等。
- 创建一个由
CompletableFuture.delayedExecutor触发的空 future，延迟即超时时间 - 用
applyToEither让两个 future 竞争，先完成者决定结果 - 超时 future 返回预设的超时标识（如 null 或自定义异常），主 future 需判断并处理
CompletableFuture<String> main = CompletableFuture.supplyAsync(() -> {
try { Thread.sleep(3000); } catch (InterruptedException e) { }
return "success";
});
CompletableFuture<String> timeout = new CompletableFuture<>();
CompletableFuture.delayedExecutor(2, TimeUnit.SECONDS)
.execute(() -> timeout.completeExceptionally(new TimeoutException("task timed out")));
return main.applyToEither(timeout, Function.identity())
.exceptionally(ex -> ex instanceof TimeoutException ? "timeout" : ex.getMessage());
注意 cancel 与中断的区别
超时后调用 future.cancel(true) 并不能保证停止正在运行的任务：
立即学习“Java免费学习笔记（深入）”；
-
cancel(true)只对响应中断的阻塞操作（如Thread.sleep、Object.wait、某些 NIO 操作）有效 - CPU 密集型任务或未检查中断状态的代码不会被真正终止
- 若需强制停止，应设计可中断逻辑（例如定期检查
Thread.interrupted()）或使用带取消语义的外部服务（如 HttpClient 的 cancel）
组合多个异步任务时的超时策略
对 allOf / anyOf 等组合操作设置超时，应在组合前分别加超时，或在组合后统一加：
- 推荐对每个子 future 单独加
orTimeout，避免单个慢任务拖垮整体 - 若统一超时，可用
anyOf+ 超时 future 包裹整个组合结果 - 注意
allOf返回的是CompletableFuture<Void>，需用thenApply显式收集结果，再加超时
