java 自定义异常结合错误码实现国际化,核心做法是定义一个包含 errorcode 字段的基类,在构造时通过 messagesource 获取对应语言的提示文本。具体操作是将错误码作为 getmessage() 的返回值,而将格式化后的中文或英文提示存入 super.getmessage()。这样既能保证前端能解析出机器可读的错误码,又能直接展示给用户友好的提示信息。

如何设计支持国际化的自定义异常基类
设计基类需要继承 RuntimeException 并引入 MessageSource。在构造函数中,利用 Spring 提供的工具类 MessageSourceAccessor 根据错误码和参数获取国际化消息。这个基类负责统一处理消息的查找逻辑,确保所有子类都能复用这一机制。

import org.springframework.context.MessageSource;
import org.springframework.context.i18n.LocaleContextHolder;
public class BaseException extends RuntimeException {
private final String errorCode;
public BaseException(String errorCode, Object... args) {
super(getMessage(errorCode, args));
this.errorCode = errorCode;
}
private static String getMessage(String code, Object[] args) {
MessageSource source = SpringContextUtil.getBean(MessageSource.class);
return source.getMessage(code, args, LocaleContextHolder.getLocale());
}
public String getErrorCode() {
return errorCode;
}
}
上述代码展示了基类的核心结构。它接收一个错误码和可变参数,调用 SpringContextUtil 获取 MessageSource 实例。通过 LocaleContextHolder.getLocale() 自动识别当前请求的语言环境。如果 messages.properties 文件中定义了 user.not.found=用户不存在,传入该错误码即可返回对应的中文提示。
立即学习“Java免费学习笔记(深入)”;
Biome 是一个基于 Rust 的高性能工具链,适用于 JavaScript、TypeScript、JSX、JSON、CSS 和 GraphQL,它将格式化和 linting 统一到一个工具中。具有 97% 的 Prettier 兼容性以及超过 450 条 lint 规则,Biome 以显著更快的执行速度取代了 ESLint 和 Prettier。
如何在业务层抛出带参数的国际化异常
在业务逻辑中,应创建具体的异常类并继承基类。当发生特定错误时,抛出该异常并传入错误码及替换参数。例如,在用户查询失败时,抛出 UserNotFoundException 并传入用户名。这种写法让异常信息既包含了结构化的错误码,又包含了动态的业务数据。

public class UserNotFoundException extends BaseException {
public UserNotFoundException(String username) {
super("user.not.found", username);
}
}
// 使用示例
if (user == null) {
throw new UserNotFoundException("张三");
}
在这个例子中,user.not.found 是资源文件中的键,username 是占位符参数。假设资源文件内容为 user.not.found=用户 {0} 不存在,最终抛出的异常消息将是“用户 张三 不存在”。同时,getErrorCode() 方法始终返回 user.not.found,方便全局异常处理器将其转换为 JSON 响应。
全局异常处理器如何提取错误码并返回JSON
全局异常处理器(@ControllerAdvice)捕获自定义异常后,需要分别提取错误码和消息。通常将错误码放在响应的 code 字段,将国际化消息放在 message 字段。这样做的好处是前端可以根据错误码进行特定的 UI 交互,如跳转登录页或显示重试按钮,而消息仅用于展示。
import org.springframework.web.bind.annotation.ExceptionHandler;
import org.springframework.web.bind.annotation.RestControllerAdvice;
@RestControllerAdvice
public class GlobalExceptionHandler {
@ExceptionHandler(BaseException.class)
public ResponseEntity<Result> handleBaseException(BaseException e) {
Result result = new Result();
result.setCode(e.getErrorCode());
result.setMessage(e.getMessage());
return ResponseEntity.badRequest().body(result);
}
}
这段代码演示了如何处理 BaseException。通过 e.getErrorCode() 获取原始错误码,通过 e.getMessage() 获取已格式化的国际化文本。返回的 Result 对象会被序列化为 JSON,例如:{"code":"user.not.found","message":"用户 张三 不存在"}。这种方式确保了前后端分离架构下,错误信息的结构化与本地化能够完美配合。

















