Java异常链通过带cause构造器（如new ServiceException("msg", e)）显式传递原始异常，完整保留堆栈根源；须避免拼接消息、误用initCause()或静默吞异常，验证printStackTrace是否含“Caused by”层级。
在 Java 中，throw 语句本身不会自动转换异常类型，但你可以通过构造新异常时传入原始异常作为 cause，实现“类型转换 + 原因保留”。关键在于：**使用带 Throwable cause 参数的构造函数，并确保新异常类型是原始异常的合理封装或业务语义升级**。
选择合适的异常类型并显式传递 cause
Java 异常体系支持链式原因（getCause()），只要新异常的构造器接受 Throwable 参数，就能保留原始堆栈根源。常见做法：
- 将检查异常（如
IOException）包装为运行时异常（如RuntimeException或自定义业务异常），避免上层强制处理 - 将底层技术异常（如
SQLException）转为领域异常（如UserNotFoundException），提升语义清晰度 - 统一异常类型（如全部转为
ServiceException），便于全局拦截和格式化响应
正确调用带 cause 的构造器
不是所有异常类都提供 Throwable 构造器，需确认目标异常是否支持。例如：
-
new RuntimeException("数据库操作失败", originalException)✅ 支持 -
new IllegalArgumentException("参数无效", originalException)✅ 支持 -
new NullPointerException("不能为 null")❌ 不接受 cause（无对应构造器）
自定义异常时，务必提供 public MyException(String message, Throwable cause) 构造器，并调用 super(message, cause)。
sc-java-to-ts-interface
下载
将后端 Java 接口文档转换为前端 TypeScript 类型定义（interface / type）。输入：飞书文档、Spring Boot 接口文档、Swagger/OpenAPI、手写 API 文档等。输出：包含请求参数与响应结果的 .md 文件，含完整 JSDoc 注释。触发关键词：Java 转 TS、接口转换、生成前端类型、接口文档转 TypeScript、DTO/VO/BO 转 interface、后端文档转前端类型、生成接口类型、类型定义生成。
立即学习“Java免费学习笔记（深入）”；
避免丢失原始堆栈和 cause 链
错误写法会切断异常链：
-
throw new ServiceException(e.getMessage());→ 仅保留消息，丢失 cause 和原始堆栈 -
throw new ServiceException("处理失败").initCause(e);→ 虽设置 cause，但不推荐；构造器传参更安全、语义更明确
正确写法：
try {
// 可能抛出 IOException
Files.readAllBytes(path);
} catch (IOException e) {
throw new ServiceException("读取配置文件失败", e); // ✅ 原始 cause 完整保留
}
必要时增强异常信息但不破坏 cause
可在保留原始 cause 的前提下，补充上下文，让问题更易定位：
- 追加当前操作、参数、ID 等关键信息到消息中
- 避免覆盖原始异常消息，而是叠加描述（如
"查询用户 ID=" + userId + " 失败: " + e.getMessage()） - 确保新消息不掩盖原始 cause ——
getCause()仍可访问原始异常及完整堆栈
