Spring Boot 中 REST 接口怎么实现国际化响应-java教程-PHP中文网

Spring Boot REST接口实现国际化响应的核心是后端动态返回多语言提示信息，需配置UTF-8编码的messages.properties资源文件、通过MessageSource加载并结合LocaleResolver识别语言环境，在接口及全局异常处理器中调用getMessage完成翻译。

spring boot 中 rest 接口怎么实现国际化响应

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

语言识别方式有三种常见选择，按推荐顺序：

Java调试

通过 JDWP 实现 Java 远程调试：连接远程 JVM、设置断点、单步执行代码、查看变量值、获取调用栈。适用于需要调试远程 Java 应用、排查运行时状态、追踪代码执行流程的场景。术语注解 JDWP：Java Debug Wire Protocol，Java 调试有线协议（Java 远程调试底层通信协议） remote JVM：远程 Java 虚拟机 step through code：代码单步调试（步入 / 步过 / 步出调试） inspect variables：变量查看 / 变量检视 stac

下载

从请求头 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);
  }
}