thenApply用于异步结果转换，需返回新值并改变链的泛型类型；thenAccept用于无返回值的副作用处理，保持原泛型类型；混用时易因类型不匹配或线程上下文丢失导致ClassCastException或MDC中断。
CompletableFuture.thenApply 用在哪？别把它当回调函数使
thenApply 是带返回值的转换操作，适用于需要把前一个异步任务的结果加工后传给下一个任务的场景。它不是用来“收尾打日志”或“发通知”的——那种情况该用 thenAccept。
常见错误现象：thenApply 里写 System.out.println 却发现返回类型不匹配，编译报错 no instance of type variable R exists；或者强行返回 null 导致后续 thenCompose 空指针。
- 只在需要“产出新值”时用
thenApply，比如String→Integer、User→UserDTO - 它的 lambda 必须有 return 语句，且返回类型会成为下链任务的输入类型
- 如果上游是
CompletableFuture<void></void>（比如来自runAsync），不能接thenApply，得用thenRun或thenAccept
示例：
CompletableFuture.supplyAsync(() -> "hello")
.thenApply(s -> s.length()) // ✅ 返回 int，下链可接 thenApply(i -> i * 2)
.thenApply(i -> i * 2);
thenAccept 适合做什么？它不改变结果类型
thenAccept 是消费型操作，典型用于副作用处理：记录日志、更新 UI、发消息，但不产生新值。它不会改变整个链的泛型类型，下游仍能拿到原始结果。
使用场景：你已经拿到最终数据，只想“看看”或“存一下”，不打算再往下传加工后的值。
当用户要求为 Java 代码添加注释、修改注释、审查注释、整理注释格式，或要求按照代码注释规范处理 Java 文件时，使用本技能。本技能用于统一生成和维护 Java 类注释模板、按 Git 对比 release 判断版本号、补充每行代码上方中文块注释、调整注释空行规则，并保持 Java 文件 UTF-8 无 BOM 编码。典型触发场景包括：补充类注释、更新 @version、检查 @author 来源、整理行尾注释、把注释放到代码上一行、检查注释是否符合规范、构建前检查 Java 注释风格。
立即学习“Java免费学习笔记（深入）”；
- lambda 参数类型必须和上游 CompletableFuture 的泛型一致，比如上游是
CompletableFuture<string></string>，参数就是String s - 它没有返回值，所以不能接
thenApply，但可以接thenRun（无参）或另一个thenAccept（如果上游仍是同类型） - 别在
thenAccept里 throw 受检异常，否则编译不过；如需异常处理，改用whenComplete
示例：
CompletableFuture.supplyAsync(() -> fetchUser())
.thenAccept(user -> log.info("Got user: {}", user.getName()))
.thenRun(() -> notifyReady()); // ✅ 后续无需 user 对象，用 thenRun
串行链中混用 thenApply 和 thenAccept 容易踩什么坑
最常出问题的是类型断层：前一个 thenApply 改变了泛型，后一个 thenAccept 却还按老类型写参数，IDE 不报错但运行时可能 ClassCastException，尤其在用了 Object 或泛型擦除的旧代码里。
- 检查每个节点的泛型签名，用 IDE 按住 Ctrl 点进去看实际类型推导结果
- 避免在链中多次转换同一对象（比如 String → Integer → String），每多一次
thenApply就多一层装箱/序列化开销 - 不要在
thenAccept里调用阻塞方法（如Thread.sleep、JDBC 查询），它默认在 ForkJoinPool 上执行，会拖慢整个线程池 - 如果某步需要切换线程（比如 UI 更新），必须显式用
thenAcceptAsync(..., SwingUtilities::invokeLater)
为什么有时候串行链没按预期执行？线程上下文丢失是主因
thenApply 和 thenAccept 默认复用上游任务完成时所在的线程（可能是 ForkJoinPool 的 worker，也可能是主线程），而不是新开线程。这意味着 MDC 日志上下文、事务传播、甚至 ThreadLocal 都可能丢失。
- 日志链路追踪断掉？加
thenApplyAsync或thenAcceptAsync并传入自定义Executor，确保 MDC 被复制 - Spring 中 @Transactional 方法被
thenApply调用时事务不生效，因为不在代理对象上调用——必须抽成独立 service 方法，再用thenApplyAsync+@Async托管 - CompletableFuture 本身不传播异常到主线程，未显式
join()或get()就结束 main 方法，任务可能根本没跑完
事情说清了就结束
