17370845950

Java异常需转化为业务提示，通过分层设计、自定义BusinessException、错误码规范（如USER_LOGIN_FAIL）、统一@ControllerAdvice处理、国际化文案及前端错误码驱动策略实现，确保不暴露技术细节、不丢失业务含义、不增加调用方负担。

Java异常可以转化为业务提示，但不是简单地把技术异常直接显示给用户，而是通过分层设计、统一异常处理机制，将底层的Exception或RuntimeException映射为可读、可控、符合业务语义的提示信息。

明确区分异常类型与业务语义

Java原生异常（如NullPointerException、SQLException）属于系统级错误，不带业务上下文。要转为业务提示，需先定义一套业务异常类（如BusinessException），并为不同场景赋予唯一错误码和提示文案。

• 避免在Service中直接抛出RuntimeException，应封装为自定义业务异常
• 错误码建议采用“模块_动作_状态”格式，例如：USER_LOGIN_FAIL、ORDER_PAY_TIMEOUT
• 提示文案区分前端展示（如“密码错误，请重试”）和后台日志（含traceId、参数快照等）

统一异常拦截与转换逻辑

使用Spring的@ControllerAdvice + @ExceptionHandler集中处理异常，将各类异常统一转为标准响应结构（如{ "code": 4001, "msg": "用户名已存在", "data": null }）。

• 对已知业务异常（如BusinessException），直接提取错误码和消息
• 对未知系统异常（如IOException），记录日志并返回通用提示（如“服务暂时不可用”），避免泄露技术细节
• 可配合ResponseEntity或全局返回包装类（如Result）确保格式一致

支持国际化与动态提示

业务提示不应写死在代码里，而应从配置或数据库加载，便于多语言支持和运营灵活调整。

• 使用MessageSource管理提示文案，按locale自动匹配中文/英文版本
• 关键提示（如支付失败原因）可存入数据库，支持后台动态修改，无需发版
• 提示中可嵌入运行时变量，如"剩余{0}次尝试机会"，用MessageFormat填充

前端友好：错误码驱动提示策略

前后端约定错误码体系，前端根据code字段决定行为：直接

• 避免前端解析异常堆栈或消息文本——易受后端文案变更影响
• 对需用户干预的错误（如表单校验失败），后端返回具体字段+错误码，前端精准定位高亮
• 敏感错误（如认证失败）不返回过多信息，防止被恶意探测

基本上就这些。核心是“不暴露技术细节、不丢失业务含义、不增加调用方负担”。异常转化不是兜底补救，而是架构设计的一环。