Java自定义异常不能跨线程自动传递，需通过Future、CompletableFuture或StructuredTaskScope等机制显式传递其副本；设计时须保证字段final、无状态修改、只读安全。
Java 中自定义异常本身不能“跨线程自动传递”，因为每个线程的异常栈是独立的。真正能传递的是异常对象的**副本或封装结果**，关键在于你用什么机制承载它、如何创建它、以及在哪一层捕获它。
自定义异常类要设计成只读且线程安全
只要满足以下条件，你的自定义异常在多线程中就是安全的，可放心被各线程独立 new 和 throw：
- 所有字段声明为 final，构造时一次性初始化（如错误码、业务 ID、时间戳等）
- 不持有外部可变对象（比如未做防御性拷贝的 List/Map），也不在
getMessage()或其他方法里修改状态 - 不提供 setter 方法，不重写
getMessage()去动态拼接内容——这会干扰堆栈可读性和调试 - 若需扩展信息（如 errorCode），单独提供 getter，不要塞进 message 字符串里
异步任务中让主线程感知异常的主流方式
子线程抛出的异常默认不会跑到主线程，必须靠显式机制“带回来”：
-
用
Future.get()：提交Callable<T>任务后，调用future.get()会把子线程中抛出的异常包装成ExecutionException，其getCause()就是你原始的自定义异常 -
用
CompletableFuture：链式调用中发生异常会进入exceptionally()或handle()；若想继续向上抛，可用thenApplyAsync(...).exceptionallyThrow()或手动封装再 throw -
结构化并发（Java 24+）：用
StructuredTaskScope启动多个子任务，scope.join()后调用scope.throwIfFailed()，自动聚合所有失败子任务的原始异常（含你的自定义类型），主线程直接 catch 即可
避免常见陷阱
这些做法会让异常“消失”或变得难以追踪：
立即学习“Java免费学习笔记（深入）”；
- 在
Runnable中 try-catch 吞掉异常却不 re-throw、不记录、不通知——错误静默丢失 - 多个线程共用同一个异常实例（比如 static 变量），再反复 throw——堆栈永远是第一次抛出的位置，掩盖真实现场
- 在线程池 submit
Runnable时没配UncaughtExceptionHandler，导致异常只打到 stderr，无人知晓 - 用
CompletableFuture.runAsync()但没处理异常分支，或在thenAccept等无返回方法里抛异常——该异常会被丢弃
推荐的最小可行实践
以线程池 + 自定义异常为例，主线程能拿到原始异常信息：
- 定义异常：
public class BizValidationException extends RuntimeException { public BizValidationException(String msg) { super(msg); } } - 提交 Callable：
Future<String> f = executor.submit(() -> { if (invalid()) throw new BizValidationException("参数非法"); return "ok"; }); - 主线程获取：
try { String r = f.get(); } catch (ExecutionException e) { Throwable cause = e.getCause(); if (cause instanceof BizValidationException) { log.warn("业务校验失败", cause); } }
