CompletableFuture.exceptionally() 用于异常时降级返回默认值，不处理异常变量而是接收Throwable决定替代结果；只在上游异常时触发，返回类型须与原始CompletableFuture泛型一致。
CompletableFuture.exceptionally() 不是用来“处理异常变量”的，而是用于在异步计算发生异常时提供一个**降级（fallback）逻辑**，返回一个默认值或替代结果，从而让流水线不中断、不抛出异常。它不接收“异常变量”作为参数去手动操作，而是接收一个 Throwable，让你基于该异常决定返回什么结果。
exceptionally() 的作用和典型用法
它只在前序异步阶段（如 supplyAsync、thenApply 等）抛出未捕获异常时触发，类似 try-catch 中的 catch 块，但作用是“兜底返回”，不是“修复异常”或“重新抛出”。
- 返回类型必须与原始 CompletableFuture 的泛型类型一致（例如
CompletableFuture的 exceptionally 必须返回String） - 它不会改变原始异常的传播路径（异常仍可被后续
handle()或whenComplete()捕获） - 它只触发一次，且仅当上游发生异常；若上游正常完成，则完全忽略
正确写法示例：兜底返回默认值
假设你异步加载用户昵称，网络失败时返回 "游客"：
CompletableFuture<string> nicknameFuture = CompletableFuture
.supplyAsync(() -> fetchNicknameFromRemote()) // 可能抛出 IOException
.exceptionally(throwable -> {
System.err.println("获取昵称失败：" + throwable.getMessage());
return "游客"; // 类型匹配，流水线继续
});</string>
后续可安全调用 thenApply(n -> "欢迎，" + n)，无需担心空指针或异常中断。
javascript-typescript-typescript-scaffold
下载
你是 TypeScript 项目架构专家，专注于脚手架搭建生产就绪的 Node.js 和前端应用。生成包含现代工具链（pnpm、Vite、Next.js）、类型
与 handle() 的关键区别
如果你需要同时处理成功和失败两种情况，或者想记录日志+返回值，handle() 更灵活：
-
exceptionally()：只处理异常分支，返回值类型强制同源 -
handle((result, ex) -> { ... })：无论成功或失败都执行，result在异常时为null，ex在成功时为null，适合统一日志、转换、或按异常类型差异化响应
例如按异常类型返回不同默认值：
.handle((result, ex) -> {
if (ex instanceof TimeoutException) return "请求超时，请重试";
if (ex instanceof IOException) return "网络不可用";
return result; // 正常情况直接透传
});
常见误区提醒
- ❌ 不要在
exceptionally中抛出新异常（除非你明确希望中断流水线）——这会让下游再次触发exceptionally或直接失败 - ❌ 不要用它来“恢复异常状态”（比如重试），重试应使用
handle+ 递归/循环调用或专门的重试库 - ❌ 它不能捕获
thenAccept、thenRun等无返回值阶段的异常——这些异常会静默丢失，需改用whenComplete或handle
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
