正确做法是用 SphO.canPass() 预检准入，或 Sentinel 1.8+ 的 AsyncEntry 异步埋点，在 supplyAsync 前校验资源；结合 handle/exceptionally 统一降级，并为不同资源隔离线程池以防止雪崩。
Java 中使用 CompletableFuture 做异步编排时，若底层服务或资源需要限流降级，直接在异步链路中嵌入 Sentinel 的传统同步 block 逻辑（如 SphU.entry()）会阻塞线程、破坏异步性，甚至引发线程池饥饿。正确做法是将 Sentinel 的保护逻辑与异步执行生命周期对齐——即在真正触发远程调用前做准入控制，并在异常时优雅 fallback，同时不干扰 CompletableFuture 的非阻塞流转。
在 supplyAsync / thenCompose 前做异步准入校验
不要在 CompletableFuture.supplyAsync() 内部调用 SphU.entry()，而应在提交任务前完成资源准入判断。Sentinel 提供了 SphO.canPass() 这种非阻塞、无副作用的预检方法，适合异步场景：
-
SphO.canPass(resource)返回true表示当前可通过，可安全发起异步调用；返回false则直接走降级逻辑 - 避免使用
SphU.entry()+try-finally exit()模式，它要求严格配对且会阻塞线程 - 示例：
return SphO.canPass("order.create") ?
CompletableFuture.supplyAsync(() -> doCreateOrder())
.handle((r, ex) -> handleResult(r, ex))
: CompletableFuture.completedFuture(fallbackOrder());
用 Sentinel 的 AsyncEntry 支持真正的异步埋点（Sentinel 1.8+）
从 Sentinel 1.8 开始支持 AsyncEntry，专为回调/CompletableFuture 场景设计。它允许你在异步操作开始时 entry，在回调完成时 exit，全程不阻塞：
Java开发手册规约集合，基于阿里巴巴Java开发手册（嵩山版）。 涵盖7大维度：编程规约、异常日志、单元测试、安全规约、MySQL数据库、工程结构、设计规约。 当用户需要：(1) 编写或审查Java代码 (2) 检查命名/代码规范 (3) 处理异常和日志 (4) 编写单元测试 (5) 安全编码 (6) 数据库设...
- 调用
SphU.asyncEntry(resource)获取AsyncEntry，立即返回（不阻塞） - 在
thenApply/exceptionally等回调中显式调用asyncEntry.exit() - 务必确保
exit()在所有分支（包括异常路径）都被调用，建议用whenComplete统一收口 - 注意：AsyncEntry 不提供 block 能力，限流决策仍依赖预检或同步 entry，它主要用于指标统计和上下文透传
把 fallback 和异常处理内聚进 CompletableFuture 链路
降级不是“兜底方法”，而是异步流程的一环。应利用 handle()、exceptionally() 或 orTimeout().exceptionally() 将限流/超时/业务异常统一转化为 fallback 结果：
立即学习“Java免费学习笔记（深入）”；
- 限流触发时，可抛出自定义异常（如
FlowException），再由exceptionally捕获并返回缓存值或空对象 - 结合
TimeLimiter（如 Resilience4j）或orTimeout()控制异步任务最大耗时，超时后自动降级 - 避免在
supplyAsync内吞异常或静默 fallback，这会让监控丢失真实失败原因 - 示例：
return CompletableFuture.supplyAsync(() -> {
if (!SphO.canPass("user.profile")) {
throw new FlowException("profile flow rejected");
}
return fetchProfile();
}).orTimeout(2, TimeUnit.SECONDS)
.exceptionally(ex -> fallbackProfile(ex));
线程池隔离 + 资源维度配置，防止雪崩传导
CompletableFuture 默认使用 ForkJoinPool.commonPool()，若被限流的服务共用该池，一个慢调用可能拖垮整个应用异步能力。必须做线程池隔离：
- 为不同资源（如“支付”、“短信”）分配独立线程池，例如
Executors.newFixedThreadPool(10) - 在
supplyAsync(func, executor)中显式传入专属线程池 - Sentinel 控制台中按资源名配置独立的 QPS/线程数规则，避免规则混用
- 配合
ThreadLocal上下文传递（如 traceId），确保异步链路中 Sentinel 的 context 不丢失（需启用ContextUtil自动适配或手动绑定）
