Java自定义异常配合国际化返回提示信息的核心是将异常与资源文件中的键绑定，通过Locale和ResourceBundle动态加载对应语言文本；需定义含错误码和参数的异常类、准备多语言.properties资源文件、封装MessageFormat解析工具类，并在全局异常处理器中统一渲染。
Java 中自定义异常配合国际化返回提示信息，核心在于**把异常与资源文件中的键（key）绑定，而不是硬编码消息**，再通过 Locale 和 ResourceBundle 动态加载对应语言的提示文本。这样既保持异常逻辑清晰，又支持多语言切换。
1. 定义带错误码和参数的自定义异常
异常类不直接持有具体提示语，而是保存错误码（code）、占位符参数（args）和可选的原始异常（cause）：
- 错误码是资源文件中 key 的名称（如 "user.not.found"）
- 参数用于填充占位符（如 {0}, {1}），适配不同语言的语序差异
- 推荐继承 RuntimeException（业务异常通常非检查型）
示例：
public class BusinessException extends RuntimeException {
private final String code;
private final Object[] args;
public BusinessException(String code, Object... args) {
this.code = code;
this.args = args;
}
// getter 省略
}
2. 准备国际化资源文件（.properties）
按语言约定命名，放在 classpath 下（如 src/main/resources/i18n/）：
-
messages_zh_CN.properties：
user.not.found=\u7528\u6237 {0} \u4e0d\u5b58\u5728 -
messages_en_US.properties：
user.not.found=User {0} not found -
messages_ja_JP.properties：
user.not.found={0}\u306e\u30e6\u30fc\u30b6\u30fc\u304c\u898b\u3064\u304b\u308a\u307e\u305b\u3093
注意：占位符统一用 {0}, {1}...，由 MessageFormat 解析，比 String.format 更适合国际化（支持不同语序、复数等）。
当用户要求为 Java 代码添加注释、修改注释、审查注释、整理注释格式，或要求按照代码注释规范处理 Java 文件时，使用本技能。本技能用于统一生成和维护 Java 类注释模板、按 Git 对比 release 判断版本号、补充每行代码上方中文块注释、调整注释空行规则，并保持 Java 文件 UTF-8 无 BOM 编码。典型触发场景包括：补充类注释、更新 @version、检查 @author 来源、整理行尾注释、把注释放到代码上一行、检查注释是否符合规范、构建前检查 Java 注释风格。
3. 创建国际化消息解析工具类
封装 ResourceBundle 加载与格式化逻辑，避免各处重复写：
public class I18nMessageUtils {
private static final String BUNDLE_NAME = "i18n.messages";
private static final ResourceBundle.Control CONTROL =
ResourceBundle.Control.getControl(ResourceBundle.Control.FORMAT_DEFAULT);
public static String getMessage(String code, Locale locale, Object... args) {
try {
ResourceBundle bundle = ResourceBundle.getBundle(BUNDLE_NAME, locale, I18nMessageUtils.class.getClassLoader(), CONTROL);
String pattern = bundle.getString(code);
return MessageFormat.format(pattern, args);
} catch (MissingResourceException | IllegalArgumentException e) {
return "Unknown error: " + code;
}
}
}
关键点：
- 使用 ResourceBundle.Control.FORMAT_DEFAULT 支持 .properties 文件自动转义
- 捕获 MissingResourceException 防止 key 缺失导致崩溃
- 建议将 locale 从请求上下文（如 Spring 的
LocaleContextHolder）获取，而非硬编码
4. 在全局异常处理器中统一渲染（以 Spring Boot 为例）
Controller 层抛出 BusinessException，由 @ControllerAdvice 捕获并组装响应：
@RestControllerAdvice
public class GlobalExceptionHandler {
@ExceptionHandler(BusinessException.class)
public ResponseEntity<apiresponse> handleBusinessException(BusinessException e, HttpServletRequest request) {
Locale locale = LocaleContextHolder.getLocale();
String message = I18nMessageUtils.getMessage(e.getCode(), locale, e.getArgs());
return ResponseEntity.badRequest().body(ApiResponse.error(message));
}
}</apiresponse>
这样前端收到的就是当前用户语言的友好提示，后端日志中仍可记录原始 code 和 args，便于排查和翻译管理。
不复杂但容易忽略：确保资源文件编码为 UTF-8，IDE（如 IntelliJ）需设置 properties 文件默认编码；Spring Boot 项目还需在 application.yml 中配置：spring.messages.basename: i18n.messages，否则 ResourceBundle 可能找不到 bundle。
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
