Symfony 4翻译失效始终显示英文默认值问题排查

看起来你的配置和翻译文件都基本正确，但有几个关键点可能被忽略了，我们一步步来解决这个问题：

1. 确保Translator与Request的Locale同步 #

虽然你已经设置了$request->setLocale('es')，但Symfony的Translator服务有时候不会自动同步这个Locale（尤其是在某些控制器逻辑中）。你可以在控制器里手动同步一下：

use Symfony\Component\Translation\TranslatorInterface;

// 你的控制器方法
public function index(Request $request, TranslatorInterface $translator)
{
    $targetLocale = 'es';
    $request->setLocale($targetLocale);
    // 手动把Translator的Locale设置为当前请求的Locale
    $translator->setLocale($targetLocale);
    
    // 现在测试翻译
    dump($translator->trans('test')); // 应该返回Value ES了
}

2. 修正翻译配置中的Fallbacks设置 #

你的translations.yml里把fallbacks设成了%locale%，而parameters.yml中默认locale是en——这会导致备用语言始终是en，虽然这不是直接导致问题的原因，但更合理的配置是把备用语言固定为默认的兜底语言（比如en）：

# config/packages/translations.yml
framework:
    default_locale: '%locale%'
    translator:
        paths:
            - '%kernel.project_dir%/translations'
        fallbacks:
            - 'en' # 这里改为固定值，而非依赖%locale%参数

3. 检查XLF翻译文件的格式完整性 #

你的翻译条目内容没问题，但要确保整个XLF文件是有效的XML格式，尤其是要包含必要的根标签和属性。比如：

messages.en.xlf：

<?xml version="1.0" encoding="UTF-8"?>
<xliff version="1.2" xmlns="urn:oasis:names:tc:xliff:document:1.2">
    <file source-language="en" datatype="plaintext" original="messages">
        <body>
            <trans-unit id="test">
                <source>test</source>
                <target>Value EN</target>
            </trans-unit>
        </body>
    </file>
</xliff>

messages.es.xlf：

<?xml version="1.0" encoding="UTF-8"?>
<xliff version="1.2" xmlns="urn:oasis:names:tc:xliff:document:1.2">
    <file source-language="en" target-language="es" datatype="plaintext" original="messages">
        <body>
            <trans-unit id="test">
                <source>test</source>
                <target>Value ES</target>
            </trans-unit>
        </body>
    </file>
</xliff>

注意目标语言文件里加上target-language="es"，这能帮助Symfony更准确地识别文件对应的语言。

4. 彻底清理缓存 #

虽然你说已经删过缓存文件夹，但建议用Symfony官方的缓存清理命令，确保没有残留的编译文件：

开发环境：

php bin/console cache:clear --env=dev

生产环境：

php bin/console cache:clear --env=prod

5. 验证Translator的当前Locale #

在控制器里输出Translator的当前Locale，确认它和Request的Locale一致：

dump($translator->getLocale()); // 应该输出'es'

如果这里输出的是en，说明Translator没有同步Request的Locale，手动调用$translator->setLocale($request->getLocale())就能解决这个问题。

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