1. 为什么微服务架构下的国际化是个“麻烦事”?
大家好,我是老张,在微服务和智能硬件领域摸爬滚打了十几年。今天想和大家聊聊一个看似基础,但在微服务架构里特别容易“踩坑”的话题:国际化(I18n)。你可能觉得,不就是多语言嘛,Spring Boot 不是自带 MessageSource 吗?直接用不就行了?
如果你在单体应用里这么想,问题不大。但一旦项目切换到像若依(RuoYi)这样的 SpringCloud 微服务架构,事情就复杂多了。想象一下这个场景:你的系统有用户服务、订单服务、商品服务,它们都是独立部署的。一个中国用户在前端切换成了英文,这个“语言偏好”信息,怎么让这所有的服务都知道?如果每个服务都去读自己的 messages_en.properties 文件,那管理起来就是一场灾难。每次加个新词条,你得在所有服务的资源文件里同步一遍,漏一个就可能导致页面显示乱码或者直接是 key 本身。
更头疼的是状态保持。用户这次访问是英文,下次通过网关进来,语言状态丢了,又变回中文了,体验非常割裂。所以,在微服务里做国际化,核心目标就两个:集中管理和状态共享。不能每个服务各自为战,得有一个统一的“指挥中心”来管理所有语言包,并且能把这个“用户当前用什么语言”的信息,顺畅地传递到每一个微服务实例中去。
基于若依SpringCloud版本来做,有个天然优势:它生态比较全,自带 Redis、Nacos 这些组件。我们的设计思路就可以很清晰——把语言包内容缓存到 Redis 实现集中管理,把用户的语言选择也存到 Redis 实现状态共享。这样,任何一个微服务需要做文本转换时,都去找 Redis 要,既保证了数据一致性,又实现了服务的无状态化。听起来是不是比到处复制粘贴配置文件靠谱多了?接下来,我就带你从零开始,把这个 I18n 子模块搭起来。
2. 模块化设计:如何打造一个可插拔的I18n子模块?
第一步,不是急着写代码,而是想清楚这个模块应该放在哪、怎么被其他服务引用。好的模块化设计,应该像一块乐高积木,即插即用,不影响主体结构。
在若依的微服务版中,你会发现有个 ruoyi-common 模块,它是所有公共依赖的“家”。我们把国际化子模块放在这里最合适,命名为 ruoyi-common-i18n。这样,其他业务模块(比如 ruoyi-system、ruoyi-auth)只需要像引入普通 Jar 包一样依赖它,就能获得全套国际化能力。
我们来看看这个子模块的 pom.xml 该怎么写。这里有个关键点需要特别注意:
<dependencies>
<!-- Spring Boot Web 基础依赖,提供Web上下文等支持 -->
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-web</artifactId>
<scope>provided</scope> <!-- 关键!设为provided -->
</dependency>
<!-- 若依公共核心,包含RedisService等工具 -->
<dependency>
<groupId>com.ruoyi</groupId>
<artifactId>ruoyi-common-core</artifactId>
</dependency>
<!-- Redis依赖,用于缓存语言包和用户语言偏好 -->
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-data-redis</artifactId>
</dependency>
<!-- 参数校验相关,为了支持验证消息的国际化 -->
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-validation</artifactId>
</dependency>
</dependencies>
注意看 spring-boot-starter-web 的 scope 被设置成了 provided。这是什么意思呢?意思是“这个模块编译和运行时需要它,但最终打包时不会把它打进去”。因为 ruoyi-common-i18n 是一个库模块(Library),而不是一个可以独立启动的应用模块。真正运行的是 ruoyi-system 这样的业务服务,它们本身已经依赖了 spring-boot-starter-web。如果我们在这里不加 provided,就会导致 Web 相关的包被重复依赖,可能引起类路径冲突或者不必要的臃肿。
那有同学会问,既然业务模块已经有 Web 依赖了,我这里不声明行不行?不行。因为我们的工具类(比如后面会讲的 I18nUtil)里用到了 RequestContextHolder 来获取当前请求,这个类来自 Web 模块。编译阶段,Java 编译器需要能找到这个类,所以必须声明依赖。用 provided 就是最优雅的解决方案:编译时存在,运行时由父模块提供。
这样设计后,在 ruoyi-system 模块中引用我们子模块时,就可以在依赖里把 spring-boot-starter-web 排除掉,让依赖树更清晰(当然,不排除也不影响运行,只是强迫症看着舒服)。
<dependency>
<groupId>com.ruoyi</groupId>
<artifactId>ruoyi-common-i18n</artifactId>
<exclusions>
<exclusion>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-web</artifactId>
</exclusion>
</exclusions>
</dependency>
3. 核心实现一:用RedisMessageSource统一管理语言包
好了,模块架子搭好了,现在进入硬核部分:如何实现一个高性能、可扩展的 MessageSource?Spring 默认用的是 ResourceBundleMessageSource,它基于类路径下的 .properties 文件。但在微服务里,这不够用。我们希望所有实例都从一个地方读配置,那就是 Redis。
3.1 自定义RedisMessageSource
我们要自己写一个 RedisMessageSource,继承 Spring 的 AbstractMessageSource。它的核心思想是:第一次访问某个语言键时,从本地配置文件加载全部词条到 Redis;后续所有请求,都直接从 Redis 查询。
350



被折叠的 条评论
为什么被折叠?



