Java异步超时控制首选CompletableFuture的orTimeout（超时抛TimeoutException，需搭配exceptionally降级）和completeOnTimeout（超时返回默认值，结果被丢弃），二者不可共存；真正终止任务需业务层响应中断或使用支持中断的API。
Java 异步任务超时控制，主要靠 CompletableFuture 提供的两个原生方法：orTimeout 和 completeOnTimeout。它们语义不同、适用场景也不同，选错容易导致降级失效或资源泄漏。
orTimeout：超时即失败，抛 TimeoutException
这是“强约束”式超时——任务没在规定时间内完成，future 就以 TimeoutException 异常状态结束，不提供默认值。
- 底层不取消正在运行的任务，只改变 future 的完成状态；适合网络请求等 I/O 场景，因为真正取消线程需业务配合（如检查
isInterrupted()） - 超时后调用
complete()或completeExceptionally()会被忽略 - 推荐搭配
exceptionally()做降级处理，例如返回空数据、缓存值或错误提示
completeOnTimeout：超时给兜底，返回默认值
这是“柔性策略”——超时后直接用指定值完成 future，原任务若之后完成，其结果会被丢弃（除非已被取走）。
Java注释规范Skills
下载
当用户要求为 Java 代码添加注释、修改注释、审查注释、整理注释格式，或要求按照代码注释规范处理 Java 文件时，使用本技能。本技能用于统一生成和维护 Java 类注释模板、按 Git 对比 release 判断版本号、补充每行代码上方中文块注释、调整注释空行规则，并保持 Java 文件 UTF-8 无 BOM 编码。典型触发场景包括：补充类注释、更新 @version、检查 @author 来源、整理行尾注释、把注释放到代码上一行、检查注释是否符合规范、构建前检查 Java 注释风格。
- 不会中断底层执行，也不抛异常；适合对响应时间敏感但允许弱一致的场景，比如首页聚合页部分数据延迟可接受
- 注意：它和
orTimeout不能共存于同一个 future，后者会覆盖前者效果 - 如果原任务耗时极长且资源占用高，仅靠这个方法无法释放资源，仍需额外设计取消逻辑
结合线程池与中断机制才真正可控
单纯设超时只是“标记失败”，不是“终止执行”。要避免线程堆积或资源泄漏，得让任务本身响应中断。
立即学习“Java免费学习笔记（深入）”；
- 在异步逻辑中主动轮询
Thread.currentThread().isInterrupted()，遇到中断就提前退出循环或清理资源 - 使用支持中断的阻塞操作（如
BlockingQueue.poll(timeout, unit)、Future.get(timeout, unit)），它们会在超时或中断时抛出InterruptedException - 自定义线程池时，可重写
beforeExecute或封装FutureTask，在超时触发时调用cancel(true)
常见误用与规避建议
很多问题源于混淆语义或忽略执行上下文。
- 别在同一个 future 上链式调用
orTimeout和completeOnTimeout，后者会生效，前者被覆盖 - 不要依赖
interrupt()来杀掉 CPU 密集型任务（如大循环、加密计算），它只设标志位，不强制终止 - 生产环境慎用
get()阻塞等待，应优先用join()+ 超时方法，或转为事件驱动链式处理 - 并行多个异步任务时（如
Stream.map().reduce()），每个子任务都应单独设超时，否则整体耗时由最慢的那个决定
