Java自定义异常通过统一错误码、可读消息和上下文参数，配合全局处理器返回标准化JSON，使前端能按code分类精准处理错误，提升错误展示效率与用户体验。
Java 自定义异常本身不直接“简化”前端错误展示，但它让后端能稳定输出结构化、语义明确的错误数据——这才是前端能高效展示的前提。关键不在抛什么异常，而在抛出后如何统一转化、携带哪些字段、前端怎么识别和响应。
定义带错误码和上下文的业务异常类
前端无法解析堆栈，只认 code 字段。所以异常必须固化 error code（如 "USER_NOT_FOUND"）、可读 message（支持占位符，如 "用户 {id} 不存在"），以及可选的上下文参数（如 {"id": "1002"}）。
推荐用枚举管理错误码，避免字符串硬编码：
- RespCode.USER_NOT_FOUND：code = "USER_NOT_FOUND"，template = "用户 {id} 不存在"
- 异常构造时传入枚举和实际参数：new BusinessException(RespCode.USER_NOT_FOUND, Map.of("id", userId))
- 全局处理器中用参数填充 template，生成最终 message，既支持国际化，又便于前端提取变量
全局拦截并返回标准化 JSON 响应
用 @RestControllerAdvice 拦住所有自定义业务异常，统一返回形如 { "code": "...", "message": "...", "data": null } 的结构体。
- HTTP 状态码按语义设：404 对应资源不存在，403 对应权限拒绝，409 对应状态冲突
- 不返回原始堆栈，不暴露内部类名或路径，防止信息泄露
- 可加 traceId 字段，方便前后端日志串联定位问题
前端按 code 主动决定展示逻辑
真正的简化发生在前端——它不再依赖后端拼好的 message 字符串，而是根据 code 分类处理：
- code 以 VALIDATION_ 开头 → 提取字段名，把提示插入对应表单控件旁
- code 是 RESOURCE_NOT_FOUND 或 PERMISSION_DENIED → 清空当前页数据，跳转到 404 或登录页
- code 是 PAY_FAILED 或 STOCK_INSUFFICIENT → 弹出强调型对话框，附带重试按钮或客服入口
- 所有错误都自动上报监控平台，带上 code 和 traceId，便于聚合分析高频错误
特殊场景：Excel 导入等批量操作
这类操作失败需精准定位到行和列，不能只说“导入失败”。自定义异常可额外携带 rowIndex、fieldName、rawValue 等字段：
- 例如抛出 new ExcelImportException(3, "phone", null, "第3行: 手机号不能为空")
- 后端响应体中透出 {"row": 3, "field": "phone", "message": "手机号不能为空"}
- 前端高亮表格第 3 行该列，并显示对应提示，用户修改后可续传，体验更平滑
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
