Java Spring MVC 怎么通过国际化配置实现多语言接口响应支持-java教程-PHP中文网

spring mvc 实现多语言接口响应的核心是将国际化能力从视图层延伸至 controller 层和 json 响应，通过 resourcebundlemessagesource 加载按 locale 命名的 utf-8 编码资源文件，在 controller 中调用 getmessage(code, args, locale) 动态获取翻译文本，并配合 cookielocaleresolver 与 localechangeinterceptor 支持 lang 参数切换语言。

java spring mvc 怎么通过国际化配置实现多语言接口响应支持

Spring MVC 实现多语言接口响应，核心是让后端返回的提示文本、错误信息、业务消息等随请求语言环境动态切换，而不是只在页面上渲染。这需要把国际化能力从视图层延伸到 Controller 层和 JSON 响应中。

资源文件按规范命名并统一管理

在 src/main/resources 下创建基础资源束文件，命名必须符合 Java Locale 标识规则：

messages.properties（默认，如英文）：welcome=Welcome
messages_zh_CN.properties：welcome=欢迎
messages_ja_JP.properties：welcome=ようこそ

文件编码一律设为 UTF-8，避免中文乱码；key 保持一致，value 按语言翻译。不建议用下划线以外的分隔符（如 zh-CN），Spring 默认只识别 zh_CN 这类格式。

配置 MessageSource 加载资源

声明 ResourceBundleMessageSource Bean，它是获取翻译文本的唯一入口：

@Bean
public MessageSource messageSource() {
    ResourceBundleMessageSource source = new ResourceBundleMessageSource();
    source.setBasename("messages");           // 对应文件前缀
    source.setDefaultEncoding("UTF-8");
    source.setUseCodeAsDefaultMessage(true);  // 找不到 key 时直接返回 code 字符串，便于排查
    return source;
}

这个 Bean 会被自动注入到任何需要获取消息的地方，比如 Controller 或 Service 中。

在 Controller 中动态获取本地化消息

接口响应内容（如 JSON 返回体中的提示字段）需显式传入当前 Locale：

Java JDK 25

Java JDK 25 来自 OpenJDK 官方归档，版本为 JDK 25，本条下载地址已指向官方 Windows x64 zip 安装包直链，适合调试旧项目或兼容旧版 Java 运行环境。

下载

通过 LocaleContextHolder.getLocale() 获取当前请求解析出的语言环境
调用 messageSource.getMessage(code, args, locale) 获取对应翻译

示例：

@GetMapping("/api/user")
public ResponseEntity<map object>> getUser() {
    Locale locale = LocaleContextHolder.getLocale();
    String msg = messageSource.getMessage("user.found", null, locale);
    
    Map<string object> result = new HashMap();
    result.put("code", 200);
    result.put("message", msg);  // ✅ 动态语言文本
    result.put("data", ...);
    return ResponseEntity.ok(result);
}</string></map>

确保请求能正确携带并解析 Locale

仅靠浏览器 Accept-Language 头不够稳定，推荐使用参数驱动 + 拦截器方式：

配置 CookieLocaleResolver 或 SessionLocaleResolver 保存用户偏好
注册 LocaleChangeInterceptor，监听 lang 参数（如 ?lang=zh_CN）并更新当前 locale

Java 配置示例：

@Bean
public LocaleResolver localeResolver() {
    CookieLocaleResolver resolver = new CookieLocaleResolver();
    resolver.setCookieName("client_lang");
    resolver.setDefaultLocale(Locale.ENGLISH);
    return resolver;
}

@Bean
public LocaleChangeInterceptor localeChangeInterceptor() {
    LocaleChangeInterceptor interceptor = new LocaleChangeInterceptor();
    interceptor.setParamName("lang"); // URL 中用 lang=zh_CN 切换
    return interceptor;
}

@Override
public void addInterceptors(InterceptorRegistry registry) {
    registry.addInterceptor(localeChangeInterceptor());
}

这样，前端调用 /api/user?lang=zh_CN 就能触发中文响应，无需改代码。

统一响应结构支持多语言字段

如果项目有全局响应封装类（如 Result<t></t>），可在构造时注入 MessageSource 和 Locale，把 message 字段做成自动翻译：

public class Result<t> {
    private int code;
    private String message; // ✅ 由 controller 传入已翻译文本
    private T data;
    // ...
}</t>

不建议在 VO/DTO 中硬编码 message，也不要在 JSON 序列化时再做翻译——逻辑应前置到 Controller 或 Service 层，保证语义清晰、可测试。

Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南