如何利用 CompletableFuture 的 exceptionallyCompose 实现带异步重试的容错链路
今天来聊聊 Ja va 并发编程里一个常见，但又特别容易踩的坑。很多人为了实现异常后的异步重试，会自然想到 exceptionallyCompose 这个名字——听起来确实很合理，对吧？但实话实说，它压根不是标准 Ja va 的 API。无论你用的是 JDK 8、11 还是 21，都找不到这么个方法
今天来聊聊 Ja va 并发编程里一个常见，但又特别容易踩的坑。很多人为了实现异常后的异步重试，会自然想到 exceptionallyCompose 这个名字——听起来确实很合理，对吧？但实话实说，它压根不是标准 Ja va 的 API。无论你用的是 JDK 8、11 还是 21，都找不到这么个方法。那个所谓的 exceptionallyComposeAsync，其实是 .NET for Android 平台对 Ja va API 的非标准绑定，只在 Android 上通过 C# 调用才能用，纯 Ja va 项目里写出来编译都过不了。
那么问题来了：想要在 Ja va 中实现“异常发生后触发异步重试”的容错链路，到底该怎么办？答案很明确——得绕开这个不存在的方法，用原生的组合能力来落地。
先弄明白：exceptionally 到底差在哪
exceptionally 接收的是一个 Function，意思是它只接受你同步返回一个 T 类型的值——字符串也好，对象也罢，哪怕是 null。但它不会接受返回 CompletableFuture 的函数。代码看起来就是这样：
// ❌ 编译失败：类型不匹配 future.exceptionally(ex -> CompletableFuture.supplyAsync(() -> "retry")); // ✅ 正确：只能返回 String，不能返回 CompletableFuturefuture.exceptionally(ex -> "fallback");
看到问题了吗？你没法在异常发生后，直接在 exceptionally 里启一个新异步任务去做重试。如果你真想实现这个效果，必须找到一个替代品——其实就是 handle 加上 thenCompose 的组合。
实战方案：用 handle 捕获异常，自己触发异步重试
在所有 CompletableFuture 的方法里，handle 是唯一一个既能拿到结果、又能拿到异常，同时还能让你返回 CompletableFuture 的入口点。它接收一个 BiFunction，注意这里的返回值 U 可以是一个 CompletableFuture<...>，只要你愿意在内部手动包装一下就行。真正的异步重试，必须由你亲手构造一个新的 CompletableFuture，别指望框架自动帮你“重放”。
典型模式长这样：
CompletableFuturewithRetry = CompletableFuture.supplyAsync(() -> { if (Math.random() < 0.7) throw new RuntimeException("fail on purpose"); return "success"; }).handle((result, ex) -> { if (ex != null) { // 异常时，启动重试（最多 2 次） return retryAsync(() -> supplyAsyncWithLogic(), 2); } return CompletableFuture.completedFuture(result); }).thenCompose(Function.identity()); // 展开嵌套的 CompletableFuture
这里面的 retryAsync 是你自己实现的工具方法，核心逻辑包含三部分：判断是否达到最大重试次数、捕获每次执行的异常但不抛出、使用 delayedExecutor 或 ScheduledExecutorService 来控制退避间隔。听起来复杂，但实现起来并不难。
一个容易翻车的细节：组合操作后的异常会静默丢失
这里必须提醒大家一点。CompletableFuture.allOf 返回的是一个 CompletableFuture，它不会携带任何子任务的异常信息。即便某个子 future 执行失败了，allOf 本身也不会失败——除非你显式调用 join() 或 get() 去把它撞出来。
同样的情况也发生在 thenCombine 上。只要任何一个入参 future 失败，整个链路的 future 就会进入异常状态。但如果你不在链尾加上 exceptionally 或 handle，异常就悄无声息地滞留在内部，直到你通过 join() 去获取它，且原始堆栈可能已经被包装成了 CompletionException。
所以，在真实的业务链路中，每个可能失败的分支都应该尽早兜底处理：
CompletableFuturetask1 = fetchUser(); CompletableFuture task2 = fetchOrder(); CompletableFuture combined = CompletableFuture.allOf(task1, task2); // ❌ 危险：combined.join() 抛出的异常无法区分是哪个子任务失败 // ✅ 应该分别处理： task1.exceptionally(ex -> { log.error("user fetch failed", ex); return "default-user"; }); task2.exceptionally(ex -> { log.error("order fetch failed", ex); return "empty-order"; });
总结一下：exceptionallyCompose 这个名字听起来再合理，它也不是 Ja va 的标准 API。所有基于它的设计，都会在编译期直接挂掉。真正的异步重试，必须靠 handle 加手动构造 CompletableFuture 加显式调度控制来落地。而且，每一层组合都必须预设异常的出口，否则错误就会在链路中悄然消失，让你查都查不到。
Postman是一套面向API全生命周期的开发与测试平台，可在Mac上发送和调试多种协议请求，管理集合、环境及认证信息，并完成脚本测试、模拟服务、监控、文档发布和团队协作。它适合开发、测试及运维人员使用，提供个人免费方案。
Docker Desktop 是 Docker 官方为 Mac 提供的容器开发环境，集成 Docker Engine、命令行工具、Compose、Build、Kubernetes 与图形化管理界面。
Android Studio 是 Google 面向安卓应用开发提供的官方集成开发环境，基于 IntelliJ IDEA 构建。它整合智能代码编辑、Gradle 构建、界面预览、设备模拟、性能分析、调试测试及 APK 分析等工具。
Xcode 是苹果面向 Mac 提供的官方集成开发环境，将代码编辑、项目构建、SwiftUI 实时预览、设备模拟、自动化测试、断点调试、性能分析和应用分发整合在同一套工作流中，适合开发与维护 iPhone、iPad、Mac、Apple Wa
JetBrains WebStorm 是面向 JavaScript、TypeScript 和现代 Web 技术的专业集成开发环境，可智能理解项目结构，提供代码补全、重构、错误检查、运行调试、测试及 Git 工具。
PhpStorm 是 JetBrains 推出的专业 PHP 集成开发环境，可在 Mac 上完成代码编写、智能检查、重构、调试、测试和数据库管理。它支持主流 PHP 框架、Composer、Git、Docker 与远程解释器。
JetBrains PyCharm 是面向 Python 开发者的集成开发环境，提供智能补全、代码检查、重构、调试、测试、版本控制及虚拟环境管理功能。Mac 版兼容 Intel 与 Apple 芯片，核心功能可免费使用。
IntelliJ IDEA 是 JetBrains 推出的专业集成开发环境，重点服务于 Java、Kotlin 与 JVM 项目开发。软件集成代码补全、静态检查、重构、调试、测试、版本控制及构建工具，并可借助插件扩展语言和框架支持。
Visual Studio Code 是微软提供的免费代码编辑器，支持 macOS，并为 Intel 与 Apple 芯片 Mac 提供适配版本。软件集代码编辑、调试、Git 源代码管理、集成终端和扩展市场于一体。
REAPER是Cockos开发的数字音频工作站，提供多轨音频与MIDI录制、剪辑、处理、混音和母带制作工具。Mac版兼容Intel与Apple芯片，支持AU、VST、VST3、CLAP等插件格式，并提供高度可定制的工作流程。
Adobe Audition 是面向播客、影视后期、音乐制作及内容创作者的专业音频工作站，提供波形精修、多轨录制与混音、频谱编辑、降噪修复、响度匹配和效果处理工具，并可与 Adobe Premiere 协同完成视频声音制作。
Pro Tools 是 Avid 推出的专业数字音频工作站，覆盖多轨录音、无损剪辑、MIDI 编曲、插件处理、自动化混音及声音与画面同步等工作。它拥有 Intro、Artist、Studio 和 Ultimate 等方案。
Postman 是面向 API 全生命周期的开发与协作平台。Windows 桌面版可用于构建和发送 HTTP、GraphQL、gRPC、WebSocket、MQTT 等请求，并提供环境变量、集合、脚本测试、模拟服务、监控、文档及团队工作区等
Docker Desktop 为 Windows 开发者提供集成式容器环境，内置 Docker Engine、命令行工具、Compose、Build 与 Kubernetes 等组件，可在本机完成镜像构建、容器运行、日志查看和资源管理。
Android Studio 是 Google 面向 Android 应用开发提供的官方集成开发环境，以 IntelliJ IDEA 为基础，集成智能代码编辑、Gradle 构建、设备模拟、界面预览、调试测试及性能分析工具，
WebStorm 是 JetBrains 面向 JavaScript、TypeScript 和现代 Web 技术打造的集成开发环境。它提供项目级代码分析、智能补全、安全重构、导航搜索，并集成调试、测试、终端、Git 与常用前端工具，
PhpStorm 是 JetBrains 面向 PHP 与现代 Web 开发打造的专业集成开发环境，提供代码补全、静态检查、重构、调试、测试、数据库、版本控制及前端语言支持。Windows 用户可直接下载安装程序，
PyCharm 是 JetBrains 推出的 Python 集成开发环境，提供智能代码补全、错误检查、重构、调试、测试、Git、终端及 Jupyter Notebook 支持。统一版安装后可体验 30 天 Pro 功能，
JetBrains IntelliJ IDEA 是以 Java、Kotlin 和 JVM 项目为核心的专业集成开发环境，提供智能补全、代码检查、安全重构、调试、测试、版本控制及构建工具集成。统一发行版的核心功能可免费用于商业和非商业项目，
Visual Studio Code 是微软推出的免费代码编辑器，Windows 版集成智能补全、代码导航、调试、终端和版本控制，并可通过扩展添加语言、格式化及远程开发能力。它启动较快、配置灵活，
REAPER 是 Cockos 推出的数字音频工作站，适用于录音、MIDI 编曲、音频编辑、混音、母带制作及声音设计。软件安装包小巧，支持多轨录制、灵活路由、自动化、第三方插件和脚本扩展，并提供完整功能的 60 天免费评估期。
Adobe Audition 是面向播客、影视后期、广播与音乐制作的专业音频工作站，提供波形编辑、多轨混音、频谱分析、录音、降噪修复和效果处理等功能。Windows 版通过 Adobe Creative Cloud 安装和管理，
Pro Tools 是 Avid 推出的专业数字音频工作站，提供多轨录音、音频剪辑、MIDI编曲、插件处理、自动化混音及影视声音制作能力。它适合音乐人、录音师、制作人和音频后期团队使用，并提供免费入门版、订阅方案及永久授权选择。
Cubase 是 Steinberg 推出的数字音频工作站，提供 MIDI 编曲、多轨录音、音频编辑、虚拟乐器、效果处理、自动化、混音和母带输出工具。其 Pro、Artist 与 Elements 版本面向不同预算和制作规模，