Java中设计支持子错误码的自定义异常，核心是通过分层枚举+接口约束实现主/子码分离与组合：定义ModuleCode主码枚举和实现SubErrorCode接口的子码枚举，构造时绑定主码；BizException持有子码对象并提供组合码、模板化消息；全局处理器统一解析、国际化、日志记录与安全响应；支持DynamicSubCode动态注入子码，子码编号从101起以保障唯一性与兼容性。
Java 中设计支持子错误码的自定义异常，核心是把“错误码体系”结构化，让主错误码（如业务模块码）和子错误码（如具体操作失败原因）可分离、可组合、可追溯。不建议用字符串拼接或硬编码整数，而应通过类型安全、可扩展的方式表达层级关系。
定义分层错误码枚举
用枚举统一管理错误码，主码与子码分离但有关联。例如：
- 定义顶层模块枚举（如 ModuleCode），每个值含固定主码（int）和模块名；
- 为每个模块定义专属子码枚举（如 UserErrorCode），实现一个通用接口（如 SubErrorCode），提供
getMainCode()、getSubCode()、getMessage()； - 子码枚举构造时传入对应主码，确保绑定关系不被破坏。
这样既保证编译期检查，又支持运行时精准解析主/子码。
设计可携带子码的异常类
自定义异常（如 BizException）应持有：
– 主错误码（int 或 ModuleCode）
– 子错误码对象（实现 SubErrorCode 接口）
– 可选的业务上下文参数（用于动态填充错误消息）
关键点：
立即学习“Java免费学习笔记（深入）”；
Alibabacloud Sdk Client Initialization For Java
下载
在 Java 中初始化和管理阿里云 SDK客户端。包括单例模式、线程安全、endpoint 与 region 配置、VPC 终端节点、同步与异步等。
- 构造函数重载：支持直接传子码枚举、或主码+子码数值+消息；
- 覆写
getErrorCode()方法，返回组合码（如mainCode * 1000 + subCode），便于日志/监控统一采集； - 消息模板化：子码枚举中定义带占位符的消息（如
"用户 {0} 不存在"），异常构造时用 MessageFormat 填充，避免字符串拼接污染异常类。
支持错误码自动解析与翻译
在全局异常处理器（如 @ControllerAdvice）中，根据抛出的 BizException 提取子码对象，做两件事：
- 调用子码的
getI18nKey()获取国际化键（如user.not.found），结合 Locale 渲染多语言提示； - 将主码、子码、参数、堆栈摘要记录到日志，格式如：
[MOD=USER, CODE=002, PARAMS=[uid:123]] 用户不存在，方便问题归因； - 对外响应时，只返回安全的主码+子码（如
{"code": "USER_002", "message": "User not found"}），不暴露内部细节。
预留扩展能力：支持运行时子码注入
某些场景（如规则引擎触发的校验失败）无法预定义全部子码。可增加一种动态子码包装器：
- 定义 DynamicSubCode 类，实现 SubErrorCode 接口；
- 允许运行时传入主码、子码值、消息模板、参数列表；
- 异常抛出时仍走同一处理链路，保证日志格式、响应结构一致。
这样兼顾了枚举的类型安全与动态场景的灵活性。
不复杂但容易忽略的是错误码的唯一性保障和演进兼容性——建议子码从 101 开始编号，留出 001–100 给保留用途；主码升级时，旧子码仍能映射到新主码下，避免客户端兼容断裂。
