CompletableFuture通过回调驱动、任务链式编排和ForkJoinPool调度实现非阻塞异步；用supplyAsync启动任务并立即返回，thenApply等方法链式响应结果，可指定线程池避免资源争用，异常需用exceptionally等显式处理。

CompletableFuture 通过组合式异步编程模型实现非阻塞异步，核心是不依赖线程挂起，而是靠回调驱动、任务链式编排和默认 ForkJoinPool 调度。它不是简单地把同步操作扔进线程池，而是让整个异步流程可描述、可组合、可错误处理，真正解耦执行与结果消费。

用 supplyAsync 启动异步任务，不阻塞主线程

supplyAsync 接收 Supplier 函数式接口，在默认 ForkJoinPool 中异步执行，并立即返回 CompletableFuture 实例，调用方线程不会等待结果。

例如：

CompletableFuture future = CompletableFuture.supplyAsync(() -> {
  Thread.sleep(1000);
  return "done";
});
// 此时主线程已继续向下执行，future 处于“未完成”状态

用 thenApply/thenAccept/thenCompose 等方法链式响应结果

这些方法注册回调函数，在前序任务完成时自动触发，且默认仍在 ForkJoinPool（或指定线程池）中执行，不阻塞当前线程。

立即学习“Java免费学习笔记（深入）”；

• thenApply：转换结果，返回新的 CompletableFuture（如 String → Integer）
• thenAccept：消费结果，无返回值，适合日志、通知等副作用操作
• thenCompose：用于扁平化嵌套的 CompletableFuture（替代 thenApply + join）

所有这些方法都“立即返回”，整个链是声明式的，执行时机由 CompletableFutures 内部状态机控制。

sc-java-to-ts-interface

将后端 Java 接口文档转换为前端 TypeScript 类型定义（interface / type）。输入：飞书文档、Spring Boot 接口文档、Swagger/OpenAPI、手写 API 文档等。输出：包含请求参数与响应结果的 .md 文件，含完整 JSDoc 注释。触发关键词：Java 转 TS、接口转换、生成前端类型、接口文档转 TypeScript、DTO/VO/BO 转 interface、后端文档转前端类型、生成接口类型、类型定义生成。

下载

显式指定线程池，避免默认 ForkJoinPool 被耗尽

默认使用 ForkJoinPool.commonPool()，但 IO 密集型任务（如 HTTP 请求、数据库查询）不宜占用它。应传入专用线程池：

ExecutorService ioPool = Executors.newCachedThreadPool();
CompletableFuture.supplyAsync(() -> callRemoteApi(), ioPool)
  .thenApply(this::parseResponse)
  .thenAccept(System.out::println);

这样既保持非阻塞，又防止 CPU 密集型与 IO 密集型任务相互干扰。

异常不传播、不中断线程，用 exceptionally 或 handle 统一处理

CompletableFuture 的异常不会抛给调用线程，而是封装在内部状态中。必须显式用 exceptionally（只处理异常）、handle（统一处理成功/失败）或 whenComplete（仅做清理）来响应。

例如：

future.exceptionally(ex -> {
  log.error("API failed", ex);
  return "fallback";
});

这保证了异步流程始终可控，不会因未捕获异常导致任务静默失败。