统一错误响应的核心是用标准结构（ResponseResult）封装异常信息，含code、errorCode、message等字段，配合@ControllerAdvice全局处理，分层设计错误码并联动日志与监控。
Java项目中统一错误响应的核心是：用一个标准结构封装所有异常信息，让前端能稳定解析、分类处理，同时后端日志和监控也能对齐口径。
定义统一错误响应体（ResponseResult）
不建议每个接口自己拼JSON，而是抽象出通用返回类，包含状态码、业务码、消息、时间戳、可选数据等字段。例如：
- code：HTTP状态码（如500）或自定义业务码（如1001），建议分层设计——HTTP码表征通信层，业务码表征领域逻辑
- errorCode：字符串形式的业务错误码（如“USER_NOT_FOUND”），便于国际化和前端 switch 判断
- message：面向用户/开发者的提示语，生产环境避免暴露堆栈或敏感路径
- timestamp：便于问题排查时与日志时间对齐
- data：成功时放业务数据，失败时可为 null 或预留扩展字段（如 traceId）
全局异常拦截：@ControllerAdvice + @ExceptionHandler
用 Spring 的全局异常处理器统一捕获 Controller 层抛出的异常，避免重复 try-catch。关键点：
- 优先捕获业务异常（如自定义的 BusinessException），返回 200 + 业务错误码，保持 HTTP 语义清晰
- 对 RuntimeException 和 Exception 做降级兜底，记录 ERROR 日志并返回通用系统错误（如“服务暂时不可用”）
- 区分是否需要暴露原始错误信息——开发环境可带 stackTrace 字段，生产环境必须关闭
- 注意不要吞掉本该 4xx 的异常（如参数校验失败），可配合 @Valid + BindingResult 或全局 MethodArgumentNotValidException 处理器
错误码体系设计：分域、可读、可追溯
错误码不是随便编号，要形成可维护的规范：
立即学习“Java免费学习笔记（深入）”；
- 按模块前缀划分：如 “USER_”, “ORDER_”, “PAY_”，避免全站共用 1001/1002
- 同一模块内按场景编号：USER_NOT_FOUND（1001）、USER_DISABLED（1002）、USER_PASSWORD_ERROR（1003）
- 所有错误码集中管理：放在 enum 或 properties 文件中，配套中文描述和建议操作（供前端展示或运维参考）
- 预留扩展位：比如 USER_0001 ~ USER_0999 给业务异常，USER_1000+ 给系统异常，方便后续扩容
与日志、链路追踪联动
错误响应不是终点，而是可观测性的起点：
- 每次构造错误响应时，记录一条 ERROR 级别日志，包含 errorCode、traceId、requestId、关键参数（脱敏后）
- 在 ResponseResult 中透传 traceId，前端可带上它反馈问题，后端快速定位整条调用链
- 对高频错误码（如 USER_LOGIN_FAIL 每分钟超 100 次）配置监控告警，而不是等用户投诉
- 避免在 message 里写“请联系管理员”，换成“登录失败次数超限，请 15 分钟后重试”，提升用户体验
