Java自定义异常动态国际化核心是延迟解析：异常仅保存错误码和参数，getMessage()中通过MessageSource或ResourceBundle按当前Locale实时解析多语言文本。
Java 中实现自定义异常的动态国际化错误信息，核心在于**把错误码（code）和参数（args）带入异常，延迟到抛出或打印时再通过 ResourceBundle 或 MessageSource 解析为对应语言的提示文本**，而不是在异常构造时就固化中文或英文字符串。
1. 定义带错误码和参数的自定义异常
异常类不直接持有具体消息，只保存可复用的错误标识和运行时变量：
- 继承 RuntimeException（或 Exception，按需选择检查型/非检查型）
- 字段包含：错误码（如 "user.not.found"）、占位符参数（Object... args）、可选的原始 cause
- 重写 getMessage() 方法，在其中触发国际化解析（避免提前计算）
示例：
public class I18nException extends RuntimeException {
private final String code;
private final Object[] args;
public I18nException(String code, Object... args) {
this.code = code;
this.args = args == null ? new Object[0] : args;
}
@Override
public String getMessage() {
// 委托给全局 MessageSource（Spring）或 ResourceBundle（原生）
return I18nUtils.getMessage(code, args);
}
}
2. 统一消息解析工具（I18nUtils）
提供线程安全、支持 Locale 的消息获取能力。根据技术栈选择实现方式：
立即学习“Java免费学习笔记（深入）”；
- Spring 环境：注入 MessageSource（如 ResourceBundleMessageSource），用当前请求 Locale 解析
- 纯 Java（无框架）：用 ResourceBundle.getBundle(..., locale) + MessageFormat 格式化
关键点：
- 确保 I18nUtils 能获取当前线程的 Locale（Web 场景通常从 RequestContextHolder 或 ThreadLocal 拿）
- 使用 MessageFormat.format(pattern, args) 支持 {0}、{1} 占位符
- 对缺失 key 提供 fallback（如返回 code 本身 + 参数列表）
3. 配置多语言资源文件
按标准命名放置 properties 文件：
- messages.properties（默认，如英文）→ user.not.found=User with id {0} not found
- messages_zh_CN.properties → user.not.found=未找到 ID 为 {0} 的用户
- messages_ja_JP.properties → user.not.found={0} のIDを持つユーザーが見つかりません
确保 Spring 的 ResourceBundleMessageSource baseName 设置为 messages，并启用 fallbackToSystemLocale。
4. 使用示例与注意事项
抛出异常时只传逻辑信息，不拼字符串：
if (user == null) {
throw new I18nException("user.not.found", userId); // ✅ 动态、可翻译
}
// ❌ 不要这样：throw new RuntimeException("未找到 ID 为 " + userId + " 的用户");
注意事项：
- 日志记录时建议同时打 error code 和 args（方便排查，不依赖 i18n 渲染）
- 前端展示错误时，后端可返回 code + args，由前端 i18n 库渲染（更彻底的前后端分离方案）
- 避免在异常中缓存已解析的消息——Locale 可能变化，每次调用 getMessage() 都应重新解析
