Java异常处理规范与编写技巧

本文深入剖析了Java异常处理的核心规范与实战技巧，强调生产环境中必须摒弃e.printStackTrace()等危险习惯，转而使用SLF4J记录带业务标识（如订单号、请求ID、金额）的可行动日志；严禁空catch掩盖故障，合理区分受检异常（仅用于调用方必须主动恢复的场景）与RuntimeException（适用于逻辑错误或不可恢复异常），推荐自定义异常优先继承RuntimeException；坚决避免finally中抛出新异常导致根因丢失，优先采用try-with-resources安全释放资源；同时要求异常信息精准、具体、脱敏，杜绝泛化描述和敏感数据明文泄露——真正考验工程师水平的，不是如何捕获异常，而是如何在职责边界内做出明智的异常决策。

避免在 catch 块里只写 e.printStackTrace()

这是最常见也最危险的习惯——它把异常信息输出到标准错误流，既没记录上下文，也没触发监控，线上出问题时根本没法定位。生产环境必须用日志框架（如 SLF4J）记录，并带上关键业务标识。

• 用 logger.error("订单支付失败，orderNo={}", orderNo, e)，而非 e.printStackTrace()
• 不要吞掉异常：空 catch 块或只打日志不抛出/不处理，等于掩盖故障
• 若决定忽略某类异常（如 InterruptedException 在清理线程时），必须加明确注释说明“为什么可忽略”

区分 RuntimeException 和受检异常的使用场景

Java 强制你处理受检异常（Exception 及其子类，但不包括 RuntimeException），但这不意味着“所有异常都该是受检的”。滥用受检异常会导致大量无意义的 throws 声明和模板式 try-catch，反而降低可读性。

• 受检异常适合：调用方**必须决策如何恢复**的场景，比如 IOException（文件不存在？重试？降级？）
• RuntimeException 更适合：程序逻辑错误或不可恢复的意外，如 IllegalArgumentException、NullPointerException（应提前校验，而非靠 catch）
• 自定义异常优先继承 RuntimeException，除非你有强契约要求调用方显式处理

不要在 finally 里执行可能抛异常的操作

finally 的本意是保证资源释放，但如果里面又抛出新异常，会覆盖原始异常，导致根因丢失——这是调试时最让人抓狂的问题之一。

• 关闭资源用 try-with-resources，它自动抑制（suppressed）后续异常，保留主异常
• 如果必须手写 finally（如老 JDK），对每个 close 操作单独 try-catch，并记录而非抛出
• 示例错误写法：finally { outputStream.close(); } —— close() 可能抛 IOException，覆盖前面的业务异常

异常信息要包含“可行动”的上下文，而非仅堆栈

堆栈告诉你“哪里出错了”，但运维和下游服务需要知道“什么条件下错的”。比如 "HTTP 500 from payment gateway" 远不如 "Payment gateway timeout after 30s, requestID=abc123, amount=¥299.00" 有用。

• 构造异常时传入组合字符串，而非拼接后丢给 getMessage()
• 避免泛化消息如 "操作失败"，换成 "无法更新用户邮箱：邮箱已被其他账号占用（email=john@example.com）"
• 敏感信息（密码、token、身份证号）必须脱敏，日志中禁止明文出现

真正难的不是捕获异常，而是判断这个异常是否属于当前方法的职责边界——该转成更上层能理解的业务异常？该静默容忍？还是该立即中断流程？这些决策点藏在 if 分支里，不在 try 块中。

今天带大家了解了的相关知识，希望对你有所帮助；关于文章的技术知识我们会一点点深入介绍，欢迎大家关注golang学习网公众号，一起学习编程~