SpringBoot项目的国际化流程

在 Spring Boot 项目已经开发完成后，想要实现国际化（i18n），让所有提示信息（后端返回的错误消息、成功消息、异常信息、枚举描述等）支持多语言，处理流程如下：
1. 创建国际化资源文件（messages.properties）

在 src/main/resources 目录下（新建 i18n 子目录），创建以下文件：

1. 1 src/main/resources/
2. 2 └── i18n/
3. 3     ├── messages.properties           # 默认语言（通常是中文或英文）
4. 4     ├── messages_zh_CN.properties     # 简体中文
5. 5     ├── messages_en_US.properties     # 美式英文
6. 6     ├── messages_zh_TW.properties     # 繁体中文（可选）
7. 7     └── messages_ja.properties        # 日语（可选）

复制代码

messages.properties（中文示例）：

1. 1 # 通用提示
2. 2 success=操作成功
3. 3 error.system=系统异常，请稍后重试
4. 4 error.notfound=资源不存在
5. 5
6. 6 # 业务提示
7. 7 user.login.success=登录成功
8. 8 user.login.fail=用户名或密码错误
9. 9 user.notfound=用户不存在

复制代码

messages_en_US.properties（英文示例）：

1. 1 success=Operation successful
2. 2 error.system=System error, please try again later
3. 3 error.notfound=Resource not found
4. 4
5. 5 user.login.success=Login successful
6. 6 user.login.fail=Username or password is incorrect
7. 7 user.notfound=User not found

复制代码

注意：

• 文件名必须以 messages 开头（Spring Boot 默认查找规则）。
  
• 所有提示统一放在 i18n 目录下，方便管理。
  

2. 配置 application.yml（或 application.properties）

1. 1 # application.yml
2. 2 spring:
3. 3   messages:
4. 4     basename: i18n/messages          # 资源文件基础名（支持通配符）
5. 5     encoding: UTF-8                 # 必须是 UTF-8
6. 6     fallback-to-system-locale: false # 推荐设置为 false（找不到对应语言时不回退到系统默认Locale）
7. 7     use-code-as-default-message: true # 找不到key时直接返回code（调试方便，上线可改为false）

复制代码

1. 1 #  properties
2. 2 spring.messages.basename=i18n/messages
3. 3 spring.messages.encoding=UTF-8
4. 4 spring.messages.fallback-to-system-locale=false
5. 5 spring.messages.use-code-as-default-message=true

复制代码

3. 自定义 LocaleResolver 和 LocaleChangeInterceptor（支持前端传参切换语言）

Spring Boot 默认使用 AcceptHeaderLocaleResolver（根据请求头 Accept-Language 自动识别），生产环境通常还需要支持通过参数或 cookie 切换语言。
使用 SessionLocaleResolver + LocaleChangeInterceptor：

1. 1 @Configuration
2. 2 public class LocaleConfig implements WebMvcConfigurer {
3. 3
4. 4     // 默认语言
5. 5     @Bean
6. 6     public LocaleResolver localeResolver() {
7. 7         SessionLocaleResolver localeResolver = new SessionLocaleResolver();
8. 8         localeResolver.setDefaultLocale(Locale.SIMPLIFIED_CHINESE); // 默认简体中文
9. 9         return localeResolver;
10. 10     }
11. 11
12. 12     // 拦截器：支持 ?lang=zh_CN 或 ?lang=en_US 切换语言
13. 13     @Bean
14. 14     public LocaleChangeInterceptor localeChangeInterceptor() {
15. 15         LocaleChangeInterceptor lci = new LocaleChangeInterceptor();
16. 16         lci.setParamName("lang"); // 前端传参名
17. 17         return lci;
18. 18     }
19. 19
20. 20     @Override
21. 21     public void addInterceptors(InterceptorRegistry registry) {
22. 22         registry.addInterceptor(localeChangeInterceptor());
23. 23     }
24. 24 }

复制代码

若优先从请求头识别，再支持参数切换，可以自定义 LocaleResolver（更灵活）。
4. 在代码中使用 MessageSource 获取国际化消息

方式一：注入 MessageSource

1. 1 @RestController
2. 2 @RequestMapping("/api")
3. 3 public class UserController {
4. 4
5. 5     @Autowired
6. 6     private MessageSource messageSource;
7. 7
8. 8     @GetMapping("/test")
9. 9     public ResponseEntity<String> test(Locale locale) { // Locale 可选从参数注入
10. 10         // 方式1：直接使用 locale 参数
11. 11         String msg = messageSource.getMessage("user.login.success", null, locale);
12. 12
13. 13         // 方式2：从 LocaleContextHolder 获取当前语言（推荐！）
14. 14         String msg2 = messageSource.getMessage("user.login.success", null, LocaleContextHolder.getLocale());
15. 15
16. 16         return ResponseEntity.ok(msg2);
17. 17     }
18. 18 }

复制代码

方式二：统一封装工具类

1. 1 @Component
2. 2 public class MessageUtils {
3. 3
4. 4     private static MessageSource messageSource;
5. 5
6. 6     @Autowired
7. 7     public void setMessageSource(MessageSource messageSource) {
8. 8         MessageUtils.messageSource = messageSource;
9. 9     }
10. 10
11. 11     /**
12. 12      * 获取国际化消息
13. 13      */
14. 14     public static String getMessage(String code, Object... args) {
15. 15         return messageSource.getMessage(code, args, LocaleContextHolder.getLocale());
16. 16     }
17. 17
18. 18     public static String getMessage(String code) {
19. 19         return getMessage(code, (Object) null);
20. 20     }
21. 21 }

复制代码

使用方式：

1. 1 throw new BusinessException(MessageUtils.getMessage("user.notfound"));
2. 2 // 或
3. 3 return Result.error(MessageUtils.getMessage("error.system"));

复制代码

5. 全局异常处理中使用国际化

1. 1 @RestControllerAdvice
2. 2 public class GlobalExceptionHandler {
3. 3
4. 4     @ExceptionHandler(BusinessException.class)
5. 5     public Result<?> handleBusinessException(BusinessException e) {
6. 6         // 假设 BusinessException 里面存了 messageCode
7. 7         String message = MessageUtils.getMessage(e.getCode(), e.getArgs());
8. 8         return Result.error(message);
9. 9     }
10. 10
11. 11     @ExceptionHandler(Exception.class)
12. 12     public Result<?> handleException(Exception e) {
13. 13         return Result.error(MessageUtils.getMessage("error.system"));
14. 14     }
15. 15 }

复制代码

6. 支持参数占位符

1. 1 # messages.properties
2. 2 user.age.limit=年龄必须在 {0} 到 {1} 岁之间

复制代码

1. 1 String msg = MessageUtils.getMessage("user.age.limit", 18, 60);
2. 2 // 输出：年龄必须在 18 到 60 岁之间

复制代码

7. 常见最佳实践总结

处理点处理方式资源文件位置src/main/resources/i18n/messages_*.properties默认语言简体中文（Locale.SIMPLIFIED_CHINESE）语言切换方式请求头 Accept-Language + ?lang=zh_CN消息获取方式优先使用 LocaleContextHolder.getLocale()工具类封装 MessageUtils 统一获取异常消息全部使用 code + MessageUtils 获取找不到key建议 use-code-as-default-message=false编码必须 UTF-8 
8. 测试方法

• 浏览器开发者工具 → Network → 修改请求头 Accept-Language: en-US,en;q=0.9
  
• 或直接在 URL 后加 ?lang=en_US
  

完成以上步骤，你的 Spring Boot 项目就实现了标准的国际化支持，所有提示信息都可以根据用户语言自动切换。
 
 
 
 
 
 

来源：程序园用户自行投稿发布，如果侵权，请联系站长删除
免责声明：如果侵犯了您的权益，请联系站长，我们会及时删除侵权内容，谢谢合作！

过来提前占个楼

谢谢分享，试用一下

新版吗？好像是停更了吧。

谢谢分享，试用一下

谢谢楼主提供！

这个好，看起来很实用

谢谢分享，辛苦了

这个好，看起来很实用

鼓励转贴优秀软件安全工具和文档！

东西不错很实用谢谢分享