Java自定义异常国际化核心是分离错误键与文案：异常仅持消息键（如USER_NOT_FOUND），文案由ResourceBundle按Locale动态加载；需配置ReloadableResourceBundleMessageSource、多语言properties文件（UTF-8编码）、枚举管理错误码，并在全局处理器中调用MessageSource.getMessage完成翻译。
Java 自定义异常实现国际化，核心是把“错误是什么”和“错误怎么说”分开：异常只携带一个消息键（如 USER_NOT_FOUND），具体文案交给外部资源文件按语言动态加载。配置不复杂，但关键环节缺一不可。
准备多语言资源文件
在 src/main/resources/i18n/ 目录下创建标准命名的 properties 文件，确保 UTF-8 编码：
-
messages_zh_CN.properties：
USER_NOT_FOUND=用户 {0} 不存在 -
messages_en_US.properties：
USER_NOT_FOUND=User {0} not found -
messages_ja_JP.properties：
USER_NOT_FOUND={0} ユーザーが存在しません
占位符统一用 {0}、{1}，与 MessageFormat 兼容；避免中文乱码，保存前确认 IDE 编码设置为 UTF-8。
配置 MessageSource Bean
在 Spring Boot 中声明 ReloadableResourceBundleMessageSource，指向资源路径：
立即学习“Java免费学习笔记（深入）”；
- 基名设为 classpath:i18n/messages（自动匹配各语言文件）
- 启用
setFallbackToSystemLocale(false)，防止找不到 key 时回退到系统语言 - 设置
setUseCodeAsDefaultMessage(true)，缺失 key 时直接返回键名，便于定位问题
示例配置类：
@Bean<br>public MessageSource messageSource() {<br> ReloadableResourceBundleMessageSource source = new ReloadableResourceBundleMessageSource();<br> source.setBasenames("classpath:i18n/messages");<br> source.setDefaultEncoding("UTF-8");<br> source.setFallbackToSystemLocale(false);<br> source.setUseCodeAsDefaultMessage(true);<br> return source;<br>}
定义可携带消息键的自定义异常
异常本身不存文案，只持有一个枚举或字符串 key 和可选参数：
- 推荐用枚举管理错误码，如
BusinessErrorCode.USER_NOT_FOUND - 构造异常时传入枚举项和动态参数（如 userId），不拼接具体文字
- 重写
getLocalizedMessage()可选，但更推荐延迟到全局处理器中解析
这样异常对象轻量、无语言绑定，也方便日志记录原始 key 用于追踪。
在全局异常处理器中完成翻译
使用 @RestControllerAdvice 捕获异常，在处理方法里调用 MessageSource.getMessage()：
- 从请求头（如
Accept-Language）或LocaleContextHolder获取当前Locale - 传入异常的 key、参数数组、locale，获取最终提示文案
- 将翻译后的消息组装进统一响应体，原始堆栈仅记日志，不返回前端
这一步实现了真正的“按需翻译”，支持默认回退，也便于测试不同语言场景。
