Play Framework i18n配置：让带国家码请求匹配通用语言文件

我之前帮不少开发者处理过类似的Play框架国际化匹配问题，你的需求其实完全不用靠堆一堆en-XX到配置里来实现，下面给你详细说清楚原因和解决方案：

问题根源 #

你遇到的情况是因为Play的默认语言匹配逻辑：当请求头是en-US这类带地区码的语言时，它会优先找完全匹配的语言标签（比如en-US），如果你的play.i18n.langs里没配置这个，且没开启回退规则，它就直接 fallback 到你设置的默认语言（也就是德语的messages文件），而不是自动匹配通用的en。

方案1：一行配置搞定（推荐） #

Play其实自带了语言层级回退的功能，只是默认没开启而已。你只需要在application.conf里加一行配置，就能让所有en-XX的请求自动匹配messages.en：

# 开启语言回退：找不到地区语言时自动用通用语言
play.i18n.fallback = true

# 保持你原来的基础语言配置就行，不用加一堆en-US、en-GB
play.i18n.langs = [ "de", "en", "fr" ]

配置完成后，当请求头是en-US、en-GB这类带地区的语言时，Play会先检查有没有对应地区的消息文件，没有的话就自动降级到通用的en语言文件，而不是直接跳默认德语。

方案2：自定义解析器（更灵活） #

如果上面的配置因为某些版本差异不生效，或者你需要更定制化的匹配逻辑（比如只给特定语言开回退），可以自己写一个语言解析器：

1. 先写一个自定义的LangResolver类，实现回退逻辑：

import play.i18n.Lang;
import play.i18n.LangResolver;
import play.mvc.Http;

import java.util.List;
import java.util.Locale;
import java.util.Optional;

public class CustomLangResolver implements LangResolver {

    private final List<Lang> supportedLangs;

    public CustomLangResolver(List<Lang> supportedLangs) {
        this.supportedLangs = supportedLangs;
    }

    @Override
    public Optional<Lang> resolve(Http.RequestHeader request) {
        // 遍历请求的Accept-Language列表，逐个尝试回退匹配
        return request.acceptLanguages().stream()
                .map(this::tryFallbackToGeneric)
                .filter(supportedLangs::contains)
                .findFirst();
    }

    private Lang tryFallbackToGeneric(Lang lang) {
        Locale locale = lang.toLocale();
        // 如果是带地区的语言，先检查通用语言是否在支持列表里
        if (!locale.getCountry().isEmpty()) {
            Lang genericLang = Lang.forCode(locale.getLanguage());
            if (supportedLangs.contains(genericLang)) {
                return genericLang;
            }
        }
        return lang;
    }
}

2. 然后绑定这个解析器到Play的依赖注入里：

import com.google.inject.AbstractModule;
import play.i18n.LangResolver;
import play.i18n.Langs;

import javax.inject.Inject;

public class I18nModule extends AbstractModule {

    private final Langs langs;

    @Inject
    public I18nModule(Langs langs) {
        this.langs = langs;
    }

    @Override
    protected void configure() {
        bind(LangResolver.class).toInstance(new CustomLangResolver(langs.availables()));
    }
}

3. 最后在application.conf里启用这个模块：

play.modules.enabled += "com.yourproject.I18nModule"

关于默认行为的疑惑 #

Play默认不开启这个回退，是因为有些场景下地区差异确实很大（比如en-US和en-GB的用词差异可能需要单独配置），所以把选择权交给开发者。很多用户都遇到过和你一样的问题，大多是没注意到play.i18n.fallback这个隐藏的配置项。

不推荐的替代方案 #

除非万不得已，别去play.i18n.langs里加一堆en-XX，不仅配置臃肿，还覆盖不了所有可能的地区码，完全没必要。

内容的提问来源于stack exchange，提问作者gun