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 工具)。
立即学习“Java免费学习笔记(深入)”;
定义可携带消息键的自定义异常
不直接存字符串,而是持有一个 key 和可选参数:
- 继承 RuntimeException 或 Exception
- 提供构造函数接收 messageKey 和 Object... args
- 重写 getLocalizedMessage(),内部调用 ResourceBundle + MessageFormat
这样异常本身不绑定语言,也不硬编码文案。
用 ResourceBundle 动态解析提示
推荐封装工具类统一加载:
- 指定基名,如 i18n.messages(对应 classpath 下
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 时用英文或兜底文案),也便于测试和维护。










