17370845950

Java异常国际化核心是分离消息键与文案，异常仅持key（如user.not.found），文案由messages.properties等资源文件按Locale动态加载，结合ResourceBundle与MessageFormat实现延迟解析，并可通过Spring的ResourceBundleMessageSource简化集成。

Java里异常信息国际化，核心是把“错在哪”和“怎么说”分开——异常只携带一个消息键（如 user.not.found），具体提示文本交给外部资源文件按语言动态加载。

准备多语言资源文件

在 src/main/resources 下创建标准命名的 .properties 文件：

• messages.properties（默认，通常为英文）
• messages_zh_CN.properties（简体中文）
• messages_en_US.properties（美式英语）

所有文件使用相同 key，例如：

user.not.found=用户不存在
user.not.found=User not found

中文需转为 Unicode（IDE 通常自动处理，或用 native2ascii 工具）。

定义可携带消息键的自定义异常

不直接存字符串，而是持有一个 key 和可选参数：

• 继承 RuntimeException 或 Exception
• 提供构造函数接收 messageKey 和 Object... args
• 重写 getLocalizedMessage()，内部调用 ResourceBundle + MessageFormat

这样异常本身不绑定语言，也不硬编码文案。

用 ResourceBundle 动态解析提示

推荐封装工具类统一加载：

• 指定基名，如 i18n.messages（对应 class

  

  path 下 i18n/messages_*.properties）
• 根据当前 Locale（从请求头、ThreadLocal 或用户配置获取）加载对应 bundle
• 用 MessageFormat.format() 填充占位符，如 Order {0} already exists

避免每次手动 new ResourceBundle，也别在异常构造时就解析——延迟到真正需要展示时再做。

与 Spring 集成更省力（推荐用于 Web 项目）

若用 Spring Boot，直接配置 ResourceBundleMessageSource Bean：

• 设置 basename = exceptions，自动匹配 exceptions_zh_CN.properties 等
• 全局异常处理器（@ControllerAdvice）中注入 MessageSource
• 捕获自定义异常后，调用 messageSource.getMessage(key, args, locale) 获取最终文案
• 返回给前端的是已翻译好的友好提示，原始异常堆栈只记日志，不暴露

这种方式解耦干净，支持默认回退（找不到 key 时用英文或兜底文案），也便于测试和维护。