快捷導(dǎo)航

SpringBoot實(shí)現(xiàn)國際化(多語言)配置的詳細(xì)步驟

更新時間：2025年09月05日 10:28:36 作者：齊飛

SpringBoot 國際化配置是實(shí)現(xiàn)應(yīng)用程序支持多語言的功能,這對于全球化的網(wǎng)站和應(yīng)用來說至關(guān)重要,SpringBoot 提供了簡潔的機(jī)制來實(shí)現(xiàn)這一目標(biāo),本文通過代碼示例和圖文介紹的非常詳細(xì),需要的朋友可以參考下

核心原理

SpringBoot國際化的核心是 MessageSource 接口，其默認(rèn)實(shí)現(xiàn)是 ResourceBundleMessageSource。它會根據(jù)當(dāng)前用戶的區(qū)域（Locale）信息，從配置的資源文件（.properties 文件）中加載對應(yīng)的文本信息。

整個過程可以分解為：

識別區(qū)域（Locale）：通過攔截器解析請求，獲取用戶的語言環(huán)境（如從請求頭、會話、參數(shù)等）。
加載資源：根據(jù)識別到的 Locale，找到對應(yīng)的 .properties 文件。
獲取文本：在代碼或模板中，通過唯一的消息鍵（key）獲取對應(yīng)的本地化文本。

詳細(xì)實(shí)現(xiàn)步驟

1.在resources文件下新建i18n文件，并新建國際化資源文件

輸入messages，添加簡體中文、繁體中文、英文

出現(xiàn)以下文件，表示創(chuàng)建成功。

messages.properties文件中添加多語言信息

中文轉(zhuǎn)為UNICODE編碼，可以找一個在線 Unicode 編碼轉(zhuǎn)換

messages.properties

10001=\u7cfb\u7edf\u7e41\u5fd9\uff0c\u8bf7\u7a0d\u540e\u518d\u8bd5\uff01
10002=\u8bf7\u52ff\u91cd\u590d\u63d0\u4ea4\uff01

messages_en_US.properties

10001=The system is busy, please try again later!
10002=Please do not resubmit!

messages_zh_CN.properties

10001=\u7cfb\u7edf\u7e41\u5fd9\uff0c\u8bf7\u7a0d\u540e\u518d\u8bd5\uff01
10002=\u8bf7\u52ff\u91cd\u590d\u63d0\u4ea4\uff01

messages_zh_TW.properties

10001=\u7cfb\u7d71\u7e41\u5fd9\uff0c\u8acb\u7a0d\u5f8c\u518d\u8a66\uff01
10002=\u8acb\u52ff\u91cd\u8907\u63d0\u4ea4\uff01

2.相關(guān)配置

application.yml

spring:
  messages:
    basename: i18n/messages
    encoding: utf-8

國際化參數(shù)解析器

import org.springframework.util.StringUtils;
import org.springframework.web.servlet.LocaleResolver;

import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;
import java.util.Locale;

/**
 * 國際化參數(shù)解析器
 *
 * @author qf
 * @date 2025-05-08 20:58:18
 */
public class HeaderLocalResolver implements LocaleResolver {
    private static final String ACCEPT_LANGUAGE = "lang";

    /**
     * 國際化參數(shù)解析方法
     */
    @Override
    public Locale resolveLocale(HttpServletRequest httpServletRequest) {
        Locale locale = Locale.getDefault();
        String acceptLanguageHeader = httpServletRequest.getHeader(ACCEPT_LANGUAGE);
        if (StringUtils.isEmpty(acceptLanguageHeader)) {
            //前端未傳lang請求頭 默認(rèn)使用簡體中文
            String[] params = LanguageEnum.CN.getLang().split("-");
            return new Locale(params[0], params[1]);
        }
        String lang = acceptLanguageHeader.split(";")[0];
        String[] params = lang.split("-");
        if (params.length == 1) {
            return locale;
        }
        locale = new Locale(params[0], params[1]);
        return locale;
    }

    @Override
    public void setLocale(HttpServletRequest request, HttpServletResponse response, Locale locale) {
    }
}

/**
 * 多語言枚舉
 * @author qf
 * @date 2025-05-08 20:58:18
 */
public enum LanguageEnum {
    // 簡體中文
    CN("zh-CN"),
    //繁體中文
    TW("zh-TW"),
    //英文
    US("en-US");

    private String lang;
    LanguageEnum(String lang) {
        this.lang = lang;
    }


    public String getLang(){
        return this.lang;
    }
}

國際化配置類

import org.springframework.beans.factory.annotation.Value;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import org.springframework.context.support.ResourceBundleMessageSource;
import org.springframework.web.servlet.LocaleResolver;

/**
 * 國際化配置類
 * @author qf
 * @date 2025-05-08 20:58:18
 */
@Configuration
public class I18nConfig {
    @Value("${spring.messages.basename:i18n.messages}")
    private String baseName;
    @Value("${spring.messages.encoding:UTF-8}")
    private String encoding;

    /**
     * 注入文本解析
     */
    @Bean(name = "messageSource")
    public ResourceBundleMessageSource getMessageResource() {
        ResourceBundleMessageSource messageSource = new ResourceBundleMessageSource();
        messageSource.setBasename(baseName);
        messageSource.setDefaultEncoding(encoding);
        return messageSource;
    }

    /**
     * 注入自定義國際化解析器
     */
    @Bean(name = "localeResolver")
    public LocaleResolver localeResolver(){
        return new HeaderLocalResolver();
    }
}

測試效果

@RestController
@RequestMapping("api")
public class TestController {
    /**
     * 通過code拿多語言下的內(nèi)容
     * @param code
     * @return
     */
    @GetMapping("/test")
    public String test(String code) {
        String message = LanguageUtil.get(code);
        return message;
    }
}