spring项目实现国际化流程解析

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

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

 success=Operation successful
 error.system=System error, please try again later
 error.notfound=Resource not found
 user.login.success=Login successful
 user.login.fail=Username or password is incorrect
 user.notfound=User not found

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

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

  @Configuration
  public class LocaleConfig implements WebMvcConfigurer {
      // 默认语言
      @Bean
      public LocaleResolver localeResolver() {
          SessionLocaleResolver localeResolver = new SessionLocaleResolver();
          localeResolver.setDefaultLocale(Locale.SIMPLIFIED_CHINESE); // 默认简体中文
          return localeResolver;
     }
     // 拦截器：支持 ?lang=zh_CN 或 ?lang=en_US 切换语言
     @Bean
     public LocaleChangeInterceptor localeChangeInterceptor() {
         LocaleChangeInterceptor lci = new LocaleChangeInterceptor();
         lci.setParamName("lang"); // 前端传参名
         return lci;
     }
     @Override
     public void addInterceptors(InterceptorRegistry registry) {
         registry.addInterceptor(localeChangeInterceptor());
     }
 }

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

  @Component
  public class MessageUtils {
      private static MessageSource messageSource;
      @Autowired
      public void setMessageSource(MessageSource messageSource) {
          MessageUtils.messageSource = messageSource;
      }
     /**
      * 获取国际化消息
      */
     public static String getMessage(String code, Object... args) {
         return messageSource.getMessage(code, args, LocaleContextHolder.getLocale());
     }
     public static String getMessage(String code) {
         return getMessage(code, (Object) null);
     }
 }

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

  @RestControllerAdvice
  public class GlobalExceptionHandler {
      @ExceptionHandler(BusinessException.class)
      public Result<?> handleBusinessException(BusinessException e) {
          // 假设 BusinessException 里面存了 messageCode
          String message = MessageUtils.getMessage(e.getCode(), e.getArgs());
          return Result.error(message);
      }
     @ExceptionHandler(Exception.class)
     public Result<?> handleException(Exception e) {
         return Result.error(MessageUtils.getMessage("error.system"));
     }
 }

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

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