java中捕获记录底层异常需用try-catch捕获具体异常类型，配合slf4j的logger.error(string, throwable)输出完整堆栈，包装异常时传入原始cause，异步和lambda中须显式处理并记录。
在 Java 方法中捕获并记录底层异常，核心是用 try-catch 捕获异常，并通过日志框架（如 SLF4J + Logback）输出带完整堆栈的错误信息，同时避免吞掉原始异常或丢失上下文。
明确捕获目标异常类型
不要直接 catch (Exception e) 捕获所有异常，应优先捕获具体异常类型（如 IOException、SQLException），便于区分处理逻辑和日志粒度。
- 对可预期的受检异常（如文件读取失败），显式声明或捕获后转换为业务语义更清晰的异常
- 对运行时异常（如
NullPointerException），通常不建议静默捕获，除非有明确兜底策略 - 若必须兜底，至少保留原始异常的
getCause()和getStackTrace()
用日志框架记录完整异常信息
使用 SLF4J 的 logger.error(String, Throwable) 重载方法，它会自动打印异常堆栈——这是记录底层异常最可靠的方式。
- ✅ 正确写法：
logger.error("文件解析失败，路径：{}", filePath, e); - ❌ 错误写法：
logger.error("文件解析失败：" + e.getMessage());（丢失堆栈、可能空指针、无上下文参数） - 避免手动调用
e.printStackTrace()，它输出到控制台且不可配置，不利于运维排查
必要时包装异常但保留根源
当需要向上层抛出新异常（例如统一返回业务异常 BizException），务必用构造函数传入原始异常作为 cause，确保链路可追溯。
-
throw new BizException("订单创建失败", e);（假设构造函数支持 cause） - 日志中仍建议先记录原始异常（
logger.error(..., e)），再抛出包装后的异常 - 避免“吃掉”异常：不要只写
catch { logger.info("忽略该异常"); }，除非有充分理由且已评审
注意异步与 Lambda 中的异常处理
在 CompletableFuture 或 Stream 的 map/forEach 中，异常不会自动传播到外层 try-catch，需显式处理。
supplyAsync(() -> doSomething()).exceptionally(ex -> { logger.error("异步任务失败", ex); return null; });- Stream 中的
forEach遇到异常会中断，可用peek+ try-catch 包裹业务逻辑，或改用传统 for 循环 - 切勿在 lambda 内吞异常却不记录——这类异常极易被忽略，导致问题难以复现
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
