Java自定义异常支持国际化的核心是通过ResourceBundle动态加载多语言资源文件，异常类仅持消息键和参数，由getMessage()按Locale格式化输出。
Java 中让自定义异常支持国际化错误信息，核心是把错误消息从硬编码字符串解耦出来，改为通过 ResourceBundle 动态加载对应语言环境（Locale）的资源文件。关键在于：异常类不直接持有消息文本，而是持有消息键（key）和参数，构造时或获取消息时再按需格式化。
1. 定义国际化资源文件
在 src/main/resources 下创建资源包目录结构，例如：
-
messages_zh_CN.properties（中文） -
messages_en_US.properties（英文） -
messages_ja_JP.properties（日文）
内容示例（messages_en_US.properties）：
invalid.email.format=Email address '{0}' is not in valid format.
中文对应（messages_zh_CN.properties）：
立即学习“Java免费学习笔记（深入）”；
user.not.found=未找到 ID 为 {0} 的用户。invalid.email.format=邮箱地址 '{0}' 格式不正确。
2. 创建可国际化的基础异常类
推荐继承 RuntimeException，并封装消息键、参数、Locale（可选）和 ResourceBundle 查找逻辑：
分析 Java Spring Boot 后端 Controller 代码，自动生成 Markdown 格式的接口文档。当用户说“生成 Java 接口文档”、“生成 API 文档”、“从 Spring 代码生成文档”时触发。
public class I18nRuntimeException extends RuntimeException {
private final String messageKey;
private final Object[] args;
private final Locale locale;
public I18nRuntimeException(String key, Object... args) {
this(key, Locale.getDefault(), args);
}
public I18nRuntimeException(String key, Locale locale, Object... args) {
super(""); // 先不设 message，避免提前格式化
this.messageKey = key;
this.args = args == null ? new Object[0] : args;
this.locale = locale;
}
@Override
public String getMessage() {
ResourceBundle bundle = ResourceBundle.getBundle("messages", locale);
String pattern = bundle.getString(messageKey);
return MessageFormat.format(pattern, args);
}
}
注意：ResourceBundle.getBundle("messages", locale) 会自动匹配 messages_*.properties 文件；MessageFormat 支持占位符如 {0}、{1,date} 等。
3. 定义具体业务异常子类（可选但推荐）
提升语义清晰度和类型安全：
public class UserNotFoundException extends I18nRuntimeException {
public UserNotFoundException(Long userId) {
super("user.not.found", userId);
}
}
public class InvalidEmailException extends I18nRuntimeException {
public InvalidEmailException(String email) {
super("invalid.email.format", email);
}
}
调用时直接抛出，无需关心本地化细节：
throw new UserNotFoundException(123L);throw new InvalidEmailException("abc@");
4. 运行时控制语言环境
全局默认 Locale 可在启动时设置：
Locale.setDefault(Locale.forLanguageTag("zh-CN"));更灵活的做法是按请求/线程切换（如 Web 应用中从 HTTP Header 或用户偏好读取）：
- 使用
ThreadLocal<locale></locale>存储当前请求语言 - 在异常构造时传入该 Locale：
new UserNotFoundException(locale, userId) - 或在
getMessage()中动态获取（需配合上下文工具类）
Spring Boot 用户可直接利用 MessageSource，将 I18nRuntimeException 改为注入 MessageSource 实例，调用 messageSource.getMessage(key, args, locale) —— 更健壮且支持 fallback。
