Java子线程异常默认不传播至主线程，需通过四种方式捕获：1. UncaughtExceptionHandler（最常用）；2. Future+Callable（适合有返回值场景）；3. 线程内手动捕获并传递；4. CompletableFuture（推荐现代异步编程）。
Java 中子线程抛出的异常默认不会传播到主线程，也不会中断其他线程，更不会被主线程的 try-catch 捕获。要捕获子线程异常，核心思路是：**让异常“可传递”或“可感知”**，常用方式有四种，按推荐程度排序如下。
使用 UncaughtExceptionHandler（最常用）
每个线程都可以设置一个未捕获异常处理器，当线程因未处理异常而终止时，JVM 会自动调用它。
- 通过
Thread.setUncaughtExceptionHandler()为单个线程设置 - 或通过
Thread.setDefaultUncaughtExceptionHandler()设置全局默认处理器 - 注意：该处理器只对 未被捕获的运行时异常和错误 生效（即没被
try-catch拦住的）
示例：
JavaStoryDevelop
下载
你接手一个需求时，是不是经常这样："改一个小字段 → 结果把不相关的代码也改了"、"需求说得很模糊 → 做着做着发现跑偏了"、"数据库加个字段 → 上线才发现漏了数据兼容"、"做了个新功能 → 一个月后自己都忘了当时怎么设计的"、"写到一半被中断 → 再回来不知道从哪继续"；这个 Skill 就是专门解决这些问题的。 它会自动探测你的项目环境（JDK、Spring Boot、ORM、数据库、前端框架），记在
Thread t = new Thread(() -> {
throw new RuntimeException("子线程出错了");
});
t.setUncaughtExceptionHandler((thread, ex) ->
System.err.println("线程 " + thread.getName() + " 异常：" + ex.getMessage())
);
t.start();
使用 Future + Callable（适合需要返回值和异常的场景）
把任务包装成 Callable 提交到线程池，用 Future.get() 主动获取结果——若子线程抛异常，get() 会封装成 ExecutionException 抛出，原始异常可通过 getCause() 获取。
立即学习“Java免费学习笔记（深入）”；
- 必须显式调用
future.get()才能触发异常传播 - 适用于任务有返回值、且主线程愿意阻塞等待结果的场景
示例：
ExecutorService es = Executors.newSingleThreadExecutor();
Future<String> future = es.submit(() -> {
throw new IOException("IO 失败");
});
try {
future.get(); // 这里抛 ExecutionException
} catch (ExecutionException e) {
Throwable cause = e.getCause(); // 原始异常：IOException
System.err.println("子线程异常：" + cause);
}
es.shutdown();
在线程内手动捕获并传递异常（简单可控）
在子线程的 run() 或 lambda 中用 try-catch 捕获异常，再通过共享变量、队列、回调等方式通知主线程。
- 适合轻量级、逻辑耦合较紧的场景
- 注意共享变量需保证线程安全（如用
AtomicReference<Throwable>或synchronized）
示例（使用原子引用）：
AtomicReference<Throwable> errorRef = new AtomicReference<>();
Thread t = new Thread(() -> {
try {
throw new IllegalArgumentException("参数不对");
} catch (Throwable e) {
errorRef.set(e);
}
});
t.start();
t.join(); // 等待结束
Throwable error = errorRef.get();
if (error != null) {
System.err.println("捕获到异常：" + error);
}
使用 CompletableFuture（现代异步编程推荐）
CompletableFuture 天然支持异常处理，可链式注册异常回调，且异常会自动传递到下游阶段。
- 调用
handle()、exceptionally()或whenComplete()即可响应异常 - 异常不会丢失，也不需要手动
join()或get()，适合组合多个异步操作
示例：
CompletableFuture.supplyAsync(() -> {
throw new NullPointerException("空指针");
}).exceptionally(ex -> {
System.err.println("异步任务失败：" + ex.getMessage());
return "默认值";
}).thenAccept(result -> System.out.println("结果：" + result));
不复杂但容易忽略：异常捕获不是“自动同步”的，关键在于选择合适机制——追求简洁用 UncaughtExceptionHandler，要结果和异常用 Future，要响应式编排用 CompletableFuture，临时调试可用共享变量兜底。
