Sulu CMS 自定义默认LocaleProvider未生效问题排查

需要实现根据用户浏览器语言、IP地址自动匹配并展示对应语言版本站点的功能，按照Sulu官方文档指引尝试自定义Locale Provider：将系统自带的RequestDefaultLocaleProvider.php复制到src目录下重命名，在services.yaml中完成服务注册，并将该服务ID配置到sulu_website.yaml的对应配置项中。访问站点时，自定义Provider内的getDefaultLocale方法始终未被调用，无法正常加载目标语言版本的站点，不清楚配置环节哪里存在错误。
额外尝试过Symfony官方推荐的实现方案：订阅onKernelRequest事件，通过$request->setLocale()方法设置所需语言，该方案同样未生效。

services.yaml #

app.locale.my_locale_provider:
class: App\Locale\MyLocaleProvider
arguments:
    - '@Sulu\Component\Webspace\Analyzer\RequestAnalyzerInterface'
    - '@Symfony\Component\HttpFoundation\RequestStack'

sulu_website.yaml #

sulu_website:
twig:
    attributes:
        urls: false
        path: false
default_locale:
    provider_service_id: app.locale.my_locale_provider

MyLocaleProvider.php #

namespace App\Locale;
use Sulu\Bundle\WebsiteBundle\Locale\DefaultLocaleProviderInterface;

class MyLocaleProvider implements DefaultLocaleProviderInterface
{       
    public function __construct()
    {       
        dump("from constructor") ;       
    }

    public function getDefaultLocale()
    {   
        dump("from getDefaultLocale") ;
        return 'de';
        
    }
}

• YAML配置缩进错误：YAML对缩进格式有强要求，当前两个配置文件的子配置项均未做正确缩进，Symfony容器无法识别层级关系，配置完全不生效。所有下级配置需要比上级配置缩进2-4个空格，修正后的配置参考：
  修正后services.yaml：

  app.locale.my_locale_provider:
      class: App\Locale\MyLocaleProvider
      # 构造方法不需要这两个参数时直接删除整段arguments配置，否则会报参数匹配错误
      arguments:
          - '@Sulu\Component\Webspace\Analyzer\RequestAnalyzerInterface'
          - '@Symfony\Component\HttpFoundation\RequestStack'
  

  修正后sulu_website.yaml：

  sulu_website:
      twig:
          attributes:
              urls: false
              path: false
      default_locale:
          provider_service_id: app.locale.my_locale_provider
  

• 服务构造参数不匹配：当前自定义MyLocaleProvider的构造方法没有定义任何入参，但服务配置中注入了两个服务实例，容器实例化服务时会直接抛出参数数量不匹配的错误，导致服务无法注册。要么删除services.yaml中的arguments配置段，要么给构造方法加上对应的两个入参声明。
• 未清理项目缓存：Sulu的Webspace、Locale相关服务会在容器编译阶段写入缓存，修改这类配置后必须执行bin/console cache:clear命令清空缓存，否则旧的缓存配置会持续生效，自定义服务不会被加载。
• 事件监听优先级错误：使用onKernelRequest事件设置Locale不生效的核心原因是优先级不够，Sulu自带的Locale解析监听器优先级为16，自定义监听器需要设置高于16的优先级，才会在Sulu的逻辑之前执行，否则手动设置的Locale会被Sulu的默认逻辑覆盖。
• 调试方式误区：如果是在prod环境测试，dump()函数不会输出任何内容，会让人误以为方法没有执行。调试阶段建议切换到dev环境，或者通过日志记录的方式验证方法执行逻辑。

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