SpringBoot实现国际化的配置方法

一、什么是“国际化”（i18n）？

• 让同一个应用能 自动显示不同语言的内容。
• 比如：
  • 用户浏览器语言是 zh-CN（简体中文）→ 显示“欢迎”
  • 用户语言是 en-US（美式英语）→ 显示“Welcome”

Spring Boot 通过 MessageSource 接口实现这一功能，而它默认使用 资源文件（properties 文件） 来存储不同语言的消息。

二、默认行为：自动配置 MessageSource

自动生效的条件：

Spring Boot 只有在 classpath 根目录下找到 messages.properties 文件时，才会自动配置 MessageSource。

也就是说：

• 如果你有 messages.properties（这是默认语言，通常是英文或中性语言），Spring Boot 会自动启用国际化支持。
• 如果你只有 messages_zh.properties 或 messages_fr.properties，但没有 messages.properties，那么 Spring Boot 不会自动配置 MessageSource！

所以：必须提供一个默认的 messages.properties，即使它是空的！

三、如何自定义资源包位置？

你可以通过 application.properties 或 application.yml 修改默认设置：

# 指定多个资源文件基名（basename），用逗号分隔
spring.messages.basename=messages,config.i18n.messages

# 是否回退到系统本地语言（默认 true）
spring.messages.fallback-to-system-locale=false

解释：

spring.messages.basename=messages,config.i18n.messages

• 表示 Spring 会去加载两类资源文件：
  1. messages.properties、messages_zh_CN.properties 等
  2. config/i18n/messages.properties、config/i18n/messages_en.properties 等
• 路径可以是：
  • 类路径根目录下的文件（如 messages.properties）
  • 包路径形式（如 config.i18n.messages → 对应 classpath:config/i18n/messages.properties）

spring.messages.fallback-to-system-locale=false

• 默认为 true：如果用户 locale 是 zh-CN，但找不到 messages_zh_CN.properties，就会尝试 messages_zh.properties → 再找不到就用系统默认 locale（比如服务器操作系统的语言）。
• 设为 false：找不到精确匹配就直接用 messages.properties（不回退到系统 locale）。

四、资源文件命名规则

假设你的 basename 是 messages，那么 Spring 会按以下优先级查找：

注意：messages.properties 是兜底文件，必须存在，否则整个国际化机制不会启动！

五、代码中如何使用？

在 Controller 或 Service 中注入 MessageSource：

@Autowired
private MessageSource messageSource;

@GetMapping("/greet")
public String greet(Locale locale) {
    return messageSource.getMessage("greeting", null, locale);
}

对应的 messages.properties：

greeting=Hello!

messages_zh.properties：

greeting=你好！

当请求带 Accept-Language: zh 时，返回“你好！”；否则返回“Hello!”。

总结关键点

建议实践

1. 在 src/main/resources/ 下创建：
   • messages.properties（默认英文）
   • messages_zh.properties（中文）

在 application.yml 中明确配置（可选但推荐）：

spring:
  messages:
    basename: messages
    fallback-to-system-locale: false

1. 在代码中通过 MessageSource 获取本地化消息。

这样你的 Spring Boot 应用就具备了多语言能力！

到此这篇关于SpringBoot支持国际化的配置方法的文章就介绍到这了,更多相关SpringBoot支持国际化内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家！

最新评论