Spring Boot REST接口实现国际化响应的核心是后端动态返回多语言提示信息，需配置UTF-8编码的messages.properties资源文件、通过MessageSource加载并结合LocaleResolver识别语言环境，在接口及全局异常处理器中调用getMessage完成翻译。
Spring Boot 中 REST 接口实现国际化响应，核心是让后端根据请求上下文动态返回对应语言的提示信息（如错误码描述、成功消息等），而不是固定写死文本。关键不在于前端传什么，而在于后端能准确识别语言环境、加载对应资源、并在任意接口中安全调用翻译逻辑。
准备多语言资源文件
在 src/main/resources 目录下创建标准命名的 properties 文件：
- messages.properties：默认语言（推荐英文，作为兜底）
- messages_zh_CN.properties：简体中文
- messages_en_US.properties：美式英文（若与默认一致可省略）
- 文件编码必须为 UTF-8（IDEA 中右键文件 → File Encoding → Convert to UTF-8）
内容示例（key 保持一致）：
user.login.fail=登录失败 user.not.found=用户不存在 validation.email.invalid=邮箱格式不正确
配置消息源和语言解析器
Spring Boot 2.4+ 默认已自动配置 MessageSource，只需在 application.yml 中声明资源路径：
spring:
messages:
basename: messages
encoding: UTF-8
语言识别方式有三种常见选择，按推荐顺序：
- 从请求头 Accept-Language 自动识别（无需额外配置，开箱即用）
-
从自定义请求头（如 lang=zh_CN）识别：需自定义
LocaleResolver -
从 URL 参数（如 ?lang=zh_CN）识别：启用
LocaleChangeInterceptor
若选自定义 header 方式，可添加如下配置类：
@Configuration
public class I18nConfig {
@Bean
public LocaleResolver localeResolver() {
return new HeaderLocaleResolver("lang");
}
static class HeaderLocaleResolver implements LocaleResolver {
private final String headerName;
HeaderLocaleResolver(String headerName) { this.headerName = headerName; }
@Override
public Locale resolveLocale(HttpServletRequest request) {
String lang = request.getHeader(headerName);
if ("zh_CN".equals(lang)) return Locale.SIMPLIFIED_CHINESE;
if ("en_US".equals(lang)) return Locale.US;
return Locale.getDefault();
}
@Override
public void setLocale(HttpServletRequest request, HttpServletResponse response, Locale locale) {}
}
}
在接口中使用国际化消息
直接注入 MessageSource，调用 getMessage 方法：
@RestController
public class UserController {
@Autowired
private MessageSource messageSource;
@GetMapping("/user/{id}")
public Result getUser(@PathVariable Long id) {
// 假设用户不存在
String msg = messageSource.getMessage(
"user.not.found",
new Object[]{id},
LocaleContextHolder.getLocale()
);
return Result.fail(msg);
}
}
- 第一个参数是资源 key（如
user.not.found） - 第二个参数是占位符值数组（如
{id}），无占位符传null - 第三个参数是当前 Locale，
LocaleContextHolder.getLocale()可自动获取已解析结果
统一异常响应中的国际化
结合全局异常处理器，让所有业务异常都走翻译流程：
- 定义带错误码的自定义异常（如
BusinessException("user.not.found", userId)） - 在
@ControllerAdvice中捕获该异常 - 用
messageSource.getMessage(code, args, locale)构造响应消息
这样无论校验失败、权限拒绝还是业务规则中断，前端收到的 message 都是当前语言的友好提示，而非硬编码英文或中文。
