本文目录导读：
Spring MVC国际化实战指南：从配置到性能优化的完整案例解析
目录导读
- 国际化核心概念与原理
- 环境搭建与基础配置（含Maven依赖）
- 三大核心组件：MessageSource、LocaleResolver、Interceptor
- 实战案例：中英文切换的登录页面
- 常见坑点与性能调优策略
- FAQ：开发者最关心的5个问题
国际化核心概念与原理
国际化（i18n）是指应用能够根据客户端语言环境自动切换显示文本，Spring MVC基于Locale和MessageSource机制实现，核心流程为：请求携带Accept-Language头或参数→LocaleResolver解析出当前Locale→MessageSource根据key查找对应语言的资源文件。
搜索引擎高频关键词：Spring MessageSource、LocaleResolver自定义、ResourceBundleMessageSource配置、国际化拦截器。
环境搭建与基础配置
Maven依赖（Spring Boot 2.7.x示例）：
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-web</artifactId>
</dependency>
<!-- 无需额外引入，spring-context已包含 -->
核心配置文件（application.properties）：
spring.messages.basename=i18n/messages spring.messages.encoding=UTF-8 spring.messages.cache-duration=3600
目录结构：
resources/i18n/
├── messages.properties (默认英文)
├── messages_zh_CN.properties (中文)
└── messages_en_US.properties (英文)三大核心组件深度解析
1 MessageSource（消息源）
使用ResourceBundleMessageSource，支持批量加载和缓存，注意baseName路径不带.properties后缀。
@Bean
public MessageSource messageSource() {
ResourceBundleMessageSource source = new ResourceBundleMessageSource();
source.setBasenames("i18n/messages", "i18n/errors");
source.setDefaultEncoding("UTF-8");
source.setCacheSeconds(3600);
return source;
}
2 LocaleResolver（地区解析器）
- AcceptHeaderLocaleResolver：默认实现,从请求头解析。
- SessionLocaleResolver：存储在session,切换后持久化。
- CookieLocaleResolver：适合记住用户选择。
@Bean
public LocaleResolver localeResolver() {
SessionLocaleResolver resolver = new SessionLocaleResolver();
resolver.setDefaultLocale(Locale.SIMPLIFIED_CHINESE);
return resolver;
}
3 LocaleChangeInterceptor（切换拦截器）
在WebMvcConfigurer中注册，拦截?lang=zh_CN之类的参数。
@Override
public void addInterceptors(InterceptorRegistry registry) {
LocaleChangeInterceptor interceptor = new LocaleChangeInterceptor();
interceptor.setParamName("lang");
registry.addInterceptor(interceptor);
}
实战案例：中英文切换登录界面
资源文件示例（messages_zh_CN.properties）：
login.title=用户登录 login.username=用户名 login.password=密码 login.submit=登录
控制器代码：
@Controller
public class LoginController {
@GetMapping("/login")
public String login(Locale locale, Model model) {
model.addAttribute("greeting",
messageSource.getMessage("login.title", null, locale));
return "login";
}
}
Thymeleaf模板（fragment部分）：
<form th:action="@{/login}">
<label th:text="#{login.username}"></label>
<input type="text"/>
<button th:text="#{login.submit}"></button>
</form>
<!-- 切换链接 -->
<a th:href="@{/login(lang='zh_CN')}">中文</a>
<a th:href="@{/login(lang='en_US')}">English</a>
关键处理：当链接带lang参数，拦截器自动更新Locale,无参数时使用Session中保存的。
常见坑点与性能优化策略
1 经典陷阱
- 编码问题：资源文件必须UTF-8，且properties文件不支持直接中文（需转Unicode）,建议使用YAML格式。
- 缓存失效：修改资源文件后需重启或清缓存（开发环境关闭缓存）。
- 参数占位符：使用
{0}、{1}传动态值：messageSource.getMessage("welcome", new Object[]{username}, locale)
2 性能优化
- 设置
cache-duration减少IO读取。 - 大项目拆分为多个资源文件（如
messages-common、messages-user）。 - 使用
ReloadableResourceBundleMessageSource用于生产热部署。
排查工具：浏览器F12查看Accept-Language头,确认LocaleResolver是否正确解析。
FAQ：开发者最关心的5个问题
Q1：我设置了中文资源文件，但页面仍显示英文？
A：检查浏览器请求头是否包含Accept-Language: zh-CN，且默认Locale与解析器配置一致，若用SessionResolver，先通过?lang=zh_CN触发切换。
Q2：properties文件中的中文乱码怎么办？ A：在IDEA中设置File Encoding为UTF-8，并使用native2ascii转换工具，或改用YAML格式（Spring Boot原生支持）。
Q3：如何动态传参数给国际化消息？
A：使用占位符，如messages_zh_CN.properties中写order.confirm=您确认删除{0}条记录吗？，然后调用getMessage("order.confirm", new Object[]{count}, locale)。
Q4：能不能同时支持请求头和参数两种切换方式？
A：可以，自定义LocaleResolver继承AbstractLocaleResolver，先检查request参数,再委托给默认解析器。
Q5：国际化对前端JS中的文本如何处理？
A：后端通过@ResponseBody提供JSON接口返回文本Map，前端用JS变量缓存；或使用th:inline="javascript"内联注入。
延伸阅读：Spring官方文档《WebMvcConfigurer》章节、《Spring in Action》第5版第6章，若需完整可运行DEMO，可参考知名开源项目如spring-petclinic的i18n实现,学习其资源文件组织方式。
