Symfony 6.3翻译功能失效及语言切换问题求助

问题背景 #

多年未使用Symfony（上一版本为Symfony 2），现基于Symfony 6.3实现基础翻译功能，遇到以下问题：

• 前端无法显示翻译内容，配置文件、翻译文件看似正常，提取翻译时法语内容可出现在导出日志中；
• 点击国旗通过AJAX调用/language/update接口切换语言，接口返回语言已切换，但刷新页面后locale仍为默认的en，翻译完全不生效。

核心问题分析 #

1. 语言选择未持久化：$request->setLocale()仅对当前请求生效，刷新页面后新请求会重新读取默认locale，无法保留用户选择的语言；
2. Locale格式不匹配：翻译文件命名为messages.fr.php，但前端传递的是fr_FR，Symfony会优先查找messages.fr_FR.php，找不到则 fallback 到默认的en；
3. 未使用官方Locale切换组件：未利用Symfony的LocaleSwitcher实现跨请求的语言持久化。

修复步骤及代码修改 #

1. 配置Locale持久化方式 #

修改config/packages/translation.yaml，添加locale_switcher配置，指定持久化方式为session或cookie：

framework:
    default_locale: en
    translator:
        default_path: '%kernel.project_dir%/translations' # 统一使用斜杠，Windows系统也兼容
        fallbacks:
            - en
    locale_switcher:
        persistence: session # 可选值：session / cookie

2. 统一Locale格式（二选一） #

• 方案一：修改翻译文件名，将messages.fr.php重命名为messages.fr_FR.php，与前端传递的locale格式一致；
• 方案二：在后端处理请求时，将完整Locale转换为短格式：

  $language = substr($request->get('language'), 0, 2); // 将fr_FR转为fr
  

3. 修改语言切换接口 #

使用LocaleSwitcher组件设置并持久化用户选择的语言：

use Symfony\Component\HttpFoundation\Request;
use Symfony\Component\HttpFoundation\JsonResponse;
use Symfony\Component\Routing\Annotation\Route;
use Symfony\Component\Locale\LocaleSwitcher;

#[Route('/language/update', methods: ['POST'])]
public function updateLanguage(Request $request, LocaleSwitcher $localeSwitcher): JsonResponse
{
    $previousLocale = $request->getLocale();
    $language = $request->get('language');
    
    // 可选：如果用方案二，添加此行转换Locale格式
    // $language = substr($language, 0, 2);
    
    // 持久化Locale设置
    $localeSwitcher->setLocale($language);

    return new JsonResponse([
        'oldLocale' => $previousLocale,
        'newLocale' => $language
    ]);
}

4. 修复前端JS选择器 #

确保所有国旗元素都绑定点击事件：

document.querySelectorAll('.language-flag').forEach(flag => {
    flag.addEventListener('click', () => {
        const selectedLanguage = flag.getAttribute('data-lang');

        const xhr = new XMLHttpRequest();
        xhr.open('POST', '/language/update', true);
        xhr.setRequestHeader('Content-Type', 'application/x-www-form-urlencoded');
        xhr.onreadystatechange = function () {
            if (xhr.readyState === XMLHttpRequest.DONE) {
                if (xhr.status === 200) {
                    console.log(xhr.responseText);
                    window.location.href = '/';
                } else {
                    console.error('Failed to update language.');
                }
            }
        };
        xhr.send('language=' + encodeURIComponent(selectedLanguage));
    });
});

验证效果 #

修改完成后：

• 点击国旗切换语言，接口返回正确的locale变更信息；
• 刷新页面后，{{ app.request.locale }}会显示用户选择的语言；
• {{ "Symfony is great"|trans }}会加载对应翻译文件中的内容。

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