java自定义异常实现国际化需解耦错误码与翻译：异常仅持业务枚举（含code、i18n key、兜底消息）和参数；getmessage()填充参数，getlocalizedmessage()延迟查resourcebundle或messagesource；spring中用messagesource+localecontextholder+@controlleradvice统一渲染，前端透传accept-language并feign显式传递。
Java 中自定义异常实现国际化错误提示，关键不是在异常构造时就固定消息，而是把“错误码”和“语言渲染”解耦，让异常只携带结构化信息（如枚举项、参数），真正翻译动作延迟到展示环节——比如日志输出、前端响应或调用 getLocalizedMessage() 时才触发。
用枚举统一管理错误码与多语言键
定义一个业务错误枚举，每个项包含唯一 code、i18n key（如 "error.user.not.found"）和英文兜底消息：
- code 用于日志追踪和监控告警，保持稳定不变
- i18n key 是资源文件里的查找标识，不直接暴露给用户
- 兜底消息确保即使资源文件缺失也能有基本提示
枚举中提供 getMessage(Locale locale) 方法，内部通过 ResourceBundle.getBundle("i18n.messages", locale) 加载对应 properties 文件（如 messages_zh_CN.properties），查不到则返回兜底消息。
自定义异常类只持错误枚举，不存具体文本
异常类（如 BusinessException）构造时强制传入该枚举实例，并可选接收格式化参数（如用户名、订单号）：
- 避免在 new 异常时就做 ResourceBundle 查找，提升性能且线程安全
- 重写
getLocalizedMessage()：从当前线程获取 Locale（推荐用 Spring 的LocaleContextHolder.getLocale()），再调用枚举的getMessage(locale) - 重写
getMessage()：用MessageFormat.format()填充参数，例如模板"用户 {0} 不存在"+ 参数"张三"→"用户张三不存在"
配合 Spring 的 MessageSource 更健壮
比起裸用 ResourceBundle，Spring 的 MessageSource（如 ReloadableResourceBundleMessageSource）更推荐：
- 自动 fallback：找不到 key 时可用默认语言文案，或直接回退到 code 字符串
- 支持热加载：修改 properties 文件无需重启服务
- 编码友好：默认 UTF-8，中文不会乱码；
setUseCodeAsDefaultMessage(true)防止 key 缺失导致空指针
全局异常处理器（@ControllerAdvice）捕获异常后，注入 MessageSource，调用 messageSource.getMessage(exception.getCode(), args, locale) 获取最终文案返回给前端。
前端语言识别与透传要闭环
后端不能假定 Locale 固定，需从请求中动态提取：
- 优先读取
Accept-Language请求头，解析为标准Locale（如zh-CN→Locale.CHINA） - 网关层可统一设置
ThreadLocal或往LocaleContextHolder写入，避免各服务重复解析 - Feign 调用时需显式透传语言标识（如加请求头），否则下游服务拿到的是默认 Locale
不复杂但容易忽略。
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
