Java异常封装核心是分层处理：底层保留原始堆栈，中间层用自定义RuntimeException携带上下文，对外仅返回带code和友好message的统一响应，严禁泄露敏感信息与技术细节。

Java 中封装异常信息处理，核心是让异常既传达明确语义，又不泄露敏感细节，同时便于日志追踪和上层决策。不是简单地“把异常包一层”，而是有层次、有边界、有目的的封装。

明确区分异常类型与封装层级

业务系统中应建立三层异常结构：

• 底层异常：来自 JDK 或框架（如 SQLException、IOException），保留原始堆栈，不直接暴露给业务层
• 中间封装异常：在 DAO 或 Service 内部转换，用自定义异常继承 RuntimeException（如 DataAccessException、RemoteCallException），携带上下文字段（如 operation="queryUser", userId=123）
• 对外异常：面向 API 层或前端，使用统一错误响应类（如 Result<T>），其中 error 字段只含 code（如 "USER_NOT_FOUND"）和用户友好的 message（如 "用户不存在"），绝不返回 stackTrace 或内部类名

封装时必须保留关键上下文

仅 throw new BusinessException("操作失败") 是无效封装。真正有用的封装要包含：

Alibabacloud Sdk Client Initialization For Java

在 Java 中初始化和管理阿里云 SDK客户端。包括单例模式、线程安全、endpoint 与 region 配置、VPC 终端节点、同步与异步等。

下载

• 唯一错误码（建议字符串，如 "ORDER_PAYMENT_TIMEOUT"，便于多语言和监控）
• 可读但不含技术细节的提示消息（避免 "NullPointerException at com.xxx.UserDao.save(UserDao.java:42)"）
• 必要业务参数快照（如 orderId="ORD-20260924-789"、amount=99.99）——通过构造函数传入，不拼接进 message
• 原始异常作为 cause 传递（new BusinessException("支付超时", originalException)），确保链路可追溯

避免封装陷阱

常见不规范做法会削弱异常价值：

立即学习“Java免费学习笔记（深入）”；

• 在 catch 块里吞掉原始异常（e.printStackTrace() 或 logger.error(e) 后不 re-throw），导致调用方无法感知失败
• 用 Exception 或 Throwable 做基类封装（如 extends Exception），强制上层处理，违背业务异常通常应快速失败的原则
• 在 finally 或 try-with-resources 中抛出新异常，覆盖原有异常（JVM 会丢弃前一个异常）
• 把敏感信息写进异常 message（如数据库连接串、用户密码、密钥片段），日志一输出就造成泄露

配合日志与监控落地

封装后的异常需与日志体系协同：

• 全局异常处理器（如 @ControllerAdvice）捕获自定义业务异常，记录 error 级别日志，必须打印完整 cause 链
• 日志中使用 MDC 添加 traceId、userId 等字段，让单次请求的所有日志可关联
• 监控系统按 error code 聚合告警，而不是按 message 文本匹配（避免因 message 微调导致告警失效）
• 对外返回的 JSON 错误体中，code 字段用于前端跳转或重试策略，message 仅用于展示，data 字段留空或返回空对象