Java异常处理规范落地关键在于杜绝吞异常，明确三类禁止行为（空catch、仅printStackTrace、静默返回），执行四条铁律（禁裸catch、日志带异常对象、finally仅资源释放、受检异常分类型处理），并借助工具链（SonarQube/SpotBugs/IDE模板）和全局处理器实现自动化管控。
Java异常处理规范落地，关键不在写多少catch，而在让吞异常的行为在编码、编译、测试阶段就无法发生。
明确“吞异常”的红线行为
团队必须共识并公示三类禁止行为，不靠提醒，靠定义清晰：
-
空catch块：只写
catch (Exception e) { }，无日志、无重抛、无注释说明 - 仅printStackTrace()：控制台输出在生产环境不可见，等同于没记录
-
静默返回默认值：如
catch (IOException e) { return null; }，未记录上下文，上游逻辑无法感知失败
建立四条强制执行的铁律
每条都需配套检查手段，不能依赖自觉：
Java注释规范Skills
下载
当用户要求为 Java 代码添加注释、修改注释、审查注释、整理注释格式，或要求按照代码注释规范处理 Java 文件时，使用本技能。本技能用于统一生成和维护 Java 类注释模板、按 Git 对比 release 判断版本号、补充每行代码上方中文块注释、调整注释空行规则，并保持 Java 文件 UTF-8 无 BOM 编码。典型触发场景包括：补充类注释、更新 @version、检查 @author 来源、整理行尾注释、把注释放到代码上一行、检查注释是否符合规范、构建前检查 Java 注释风格。
-
禁止裸catch：每个
catch块必须含日志（log.error("xxx", e)）、包装重抛（throw new BusinessException(..., e)）或带注释的业务兜底 -
日志必须带原始异常对象：禁用
log.error("失败")，必须用log.error("读取配置失败", e)保留堆栈 -
finally中禁止业务逻辑：只允许资源释放（
close()、shutdown()），禁用日志、调用服务、修改状态 -
受检异常必须显式分类型处理：不允许
catch (Exception e)一锅端，须按IOException、SQLException等实际类型分块捕获，或向上声明
用工具把规范变成“写代码时的肌肉记忆”
人工review覆盖有限，工具链要嵌入开发流程：
立即学习“Java免费学习笔记（深入）”；
- 在SonarQube或SpotBugs中启用规则：RSPEC-1166（空catch）、RSPEC-2583（日志缺异常参数）、RSPEC-1149（finally含return/throw）
- 为IDE配置Live Template：输入
tc自动展开为标准catch块，含SLF4J日志+re-throw模板 - Service接口方法签名强制声明受检异常，避免底层IO/SQL异常被隐式吞掉
收口到全局异常处理器，减少分散try-catch
Controller层不写业务级try-catch，统一交由@RestControllerAdvice处理：
-
业务异常（如
BusinessException）→ 返回结构化错误码（如B0001）和用户提示语 -
系统异常（
RuntimeException）→ 记录完整堆栈，返回通用HTTP 500 -
受检异常（如
IOException）→ 在Service层抛出，全局处理器转为对应HTTP状态码（如404、503）
