如何统一企业级项目中的异常变量输出，采用StandardException与错误码（Error Code）规范？

本文共计769个文字，预计阅读时间需要4分钟。

在商业级项目中，StandardException不是一个JDK或Spring内置类，而是团队约定的统一异常基类。它承载错误码（ErrorCode）、可读消息、上下文数据等关键信息，使异常从抛出即消失转变为可识别、可追踪、可响应的结构化符号。

错误码必须集中管理，不能硬编码

所有业务异常必须通过枚举类（如 ErrorCode）定义错误码，禁止在 throw 语句里直接拼字符串或数字。例如：

• USER_NOT_FOUND("USER_001", "用户不存在")
• ORDER_EXPIRED("ORDER_005", "订单已过期，请重新下单")

枚举字段应包含：code 字符串（便于前端 switch）、中文提示（开发/测试用）、英文描述（国际化基础）、HTTP 状态建议值（如 404 对应 USER_NOT_FOUND）。

StandardException 基类要强制绑定 ErrorCode

自定义异常必须继承一个统一基类（如 StandardException），且构造函数只接受 ErrorCode 枚举或其 code 字符串，不允许多余重载。