Java中业务异常 BusinessException 怎么配合错误码 Enum 封装-java教程-PHP中文网

businessexception 配合错误码枚举封装，实现结构化、可读、可扩展的异常处理：定义含编码、消息占位符、http状态码的字符串型枚举；异常继承runtimeexception，构造时传入枚举及参数；统一@controlleradvice拦截并返回标准响应体；错误码需契约化管理与协作。

java中业务异常 businessexception 怎么配合错误码 enum 封装

业务异常 BusinessException 配合错误码枚举（Enum）封装，核心是让异常携带结构化、可读、可扩展的错误信息，同时避免硬编码字符串或数字，提升维护性和国际化支持能力。

定义统一错误码枚举

错误码枚举应包含唯一编码（如字符串或整数）、提示消息（可预留多语言占位）、HTTP 状态码（可选）等字段。推荐用字符串编码（如 "USER_NOT_FOUND"），语义清晰且不易冲突。

每个枚举项代表一个明确的业务失败场景，例如用户不存在、余额不足、参数校验失败等
消息字段建议使用占位符（如 "用户 {0} 不存在"），便于后续配合 MessageSource 实现国际化
避免在枚举中直接拼接动态值，保持枚举纯粹性

设计 BusinessException 继承 RuntimeException

BusinessException 应为运行时异常，无需强制 try-catch，符合业务流程中“非预期但可预知”的失败场景定位。构造函数接收错误码枚举 + 可变参数（用于填充消息占位符）。

Java Maven Code Review

审查Java Maven项目（ZIP压缩包或GitLab仓库URL），检查代码规范、命名、模块边界、可维护性问题以及重复代码。

下载

内部持有 ErrorCode 枚举引用，提供 getCode()、getMessage()（经参数填充后）等访问方法
重写 toString() 或提供 getDetail() 方法，方便日志记录完整上下文
可额外携带 traceId、requestId 等诊断字段（通过 ThreadLocal 或调用链透传）

统一异常处理器捕获并响应

通过 @ControllerAdvice + @ExceptionHandler(BusinessException.class) 拦截，将枚举中的错误码、填充后的消息、HTTP 状态码组装成标准响应体（如 { "code": "USER_NOT_FOUND", "message": "用户 abc123 不存在" }）。

避免在 controller 层手动 new 异常并 throw，推荐封装工具类（如 Exceptions.illegalArgument(ErrorCode.USER_NOT_FOUND, userId)）
响应体结构建议固定字段：code（枚举 name() 或 code 值）、message（本地化后）、timestamp、traceId（如有）
对同一错误码，前端可基于 code 做精准提示或跳转，无需解析 message 文本