complete() 方法用于手动设置 CompletableFuture 的结果并唤醒等待线程，本身不阻塞；真正阻塞的是 get() 或 join()，它们等待 complete() 调用后才返回。
CompletableFuture 的 complete() 方法不是用来“阻塞”的，而是用来“手动设置结果”并唤醒等待的线程。 它本身不阻塞，相反，它是解决阻塞等待（如 get()）的关键出口——调用 complete(value) 后，所有正在调用 get() 或 join() 的线程会立即返回结果，不再阻塞。
为什么不能用 complete() 实现“阻塞”？
complete() 是一个非阻塞的、一次性写入方法：
- 它只在 CompletableFuture 还未完成时生效；如果已由其他方式（如异步任务、
completeExceptionally()）完成，则直接返回false，不覆盖结果。 - 它不会让当前线程暂停或等待，也不会主动触发任何阻塞逻辑。
- 真正造成阻塞的是
get()（带超时）或join()（无检查异常），它们会挂起当前线程，直到被complete()、任务自然结束或超时。
典型手动完成 + 等待的用法
常见场景：主线程创建 CompletableFuture，另启线程/回调中调用 complete()，主线程用 get() 同步等待结果。
Alibabacloud Sdk Client Initialization For Java
下载
在 Java 中初始化和管理阿里云 SDK客户端。包括单例模式、线程安全、endpoint 与 region 配置、VPC 终端节点、同步与异步等。
示例：
立即学习“Java免费学习笔记（深入）”；
CompletableFuture<String> future = new CompletableFuture<>();
// 在另一个线程中模拟异步操作后手动完成
new Thread(() -> {
try {
Thread.sleep(1000); // 模拟耗时操作
future.complete("done!"); // ✅ 此处唤醒所有等待者
} catch (InterruptedException e) {
future.completeExceptionally(e);
}
}).start();
// 主线程阻塞等待（直到 complete 被调用）
String result = future.get(); // 阻塞约 1 秒后返回 "done!"
System.out.println(result);
注意 complete() 的几个关键行为
-
仅一次有效：重复调用
complete()只有第一次成功，后续忽略。 -
不能覆盖已完成状态：若已被
completeExceptionally()或任务自然完成，complete()失败（返回false）。 - 线程安全：可在任意线程安全调用，无需额外同步。
-
不触发 thenApply/thenAccept 等回调的执行时机：回调会在
complete()调用后，由内部线程池（或调用线程，取决于构造方式）异步调度，不是立即同步执行。
替代方案：需要“可控阻塞”时的建议
如果目标是“等某个条件满足再继续”，除了 get() + complete()，还可考虑：
- 用
CountDownLatch或Phaser显式控制等待与释放； - 用
CompletableFuture.delayedExecutor()配合orTimeout()实现带超时的等待； - 避免长期阻塞主线程，优先使用
thenAccept()、whenComplete()等非阻塞组合方式。
