i18next忽略Accept-Language备选语言，如何优先使用支持的法语？

在Node+EJS应用中使用i18next-fs-backend和i18next-http-middleware，支持en、fr两种语言。当前遇到的问题是：当客户端Accept-Language为[fr]时可正常显示法语，但为[es, fr]时，系统直接回退到英语，没有使用备选的法语。

问题根源在于默认的语言检测配置没有遍历Accept-Language中的所有候选语言，遇到不支持的es后直接触发回退逻辑。通过修改i18next的初始化配置，让语言检测器检查所有候选语言直到找到支持的选项即可解决：

const i18next = require('i18next'),
      i18next_backend = require('i18next-fs-backend'),
      i18next_middleware = require('i18next-http-middleware');

i18next
    .use(i18next_backend)
    .use(i18next_middleware.LanguageDetector)
    .init({
        preload: ['en', 'fr'],
        fallbackLng: 'en',
        // 新增语言检测配置
        detection: {
            checkWhitelist: true, // 只允许从支持的语言列表中选择
            order: ['acceptLanguage'], // 优先读取Accept-Language请求头
            lookupAcceptLanguage: 'accept-language' // 指定读取的请求头字段
        },
        whitelist: ['en', 'fr'], // 明确声明支持的语言集合
        backend: {
            loadPath: path.join(__dirname, '/locales/{{ns}}-{{lng}}.json')
        }, 
        debug: true
    });

app.use(i18next_middleware.handle(i18next));

关键配置说明 #

• checkWhitelist: true：强制语言检测器仅从whitelist或preload列表中选取语言，避免使用不支持的语言代码。
• whitelist: ['en', 'fr']：明确列出支持的语言，配合checkWhitelist使用后，检测器会遍历Accept-Language中的所有值，跳过不支持的es，继续检查下一个候选的fr。
• order: ['acceptLanguage']：如果不需要其他语言检测来源（如路径、Cookie），可仅保留该选项；若需多来源检测，可按需求调整顺序。

配置完成后，当Accept-Language为es, fr时，系统会自动跳过不支持的西班牙语，选择备选的法语作为当前语言，而非直接回退到英语。

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