Sylius配置问题：默认语言无前缀/、二级语言带/nl/前缀致重定向循环

一、核心配置步骤 #

1. 调整路由配置（config/routes/sylius_shop.yaml） #

默认的sylius_shop_default_locale路由会触发无前缀请求的重定向，必须修改规则避免冲突，同时分别配置默认语言和二级语言的路由：

# 限制默认locale路由仅匹配nl前缀请求，避免干扰默认语言根路径
sylius_shop_default_locale:
    resource: "@SyliusShopBundle/Resources/config/routing/default_locale.yaml"
    prefix: /{_locale}
    requirements:
        _locale: ^nl$
    defaults:
        _locale: nl_NL

# 英语（en_US）无前缀根路由
sylius_shop_en:
    resource: "@SyliusShopBundle/Resources/config/routing.yml"
    prefix: /
    defaults:
        _locale: en_US

# 荷兰语（nl_NL）带前缀路由
sylius_shop_nl:
    resource: "@SyliusShopBundle/Resources/config/routing.yml"
    prefix: /nl
    defaults:
        _locale: nl_NL

2. 配置Locale核心参数（config/packages/sylius_locale.yaml） #

设置可用语言、默认语言，并指定语言切换的存储和路由生成方式：

sylius_locale:
    enabled_locales:
        - en_US
        - nl_NL
    default_locale: en_US
    locale_switcher:
        storage: session  # 用会话存储用户语言偏好，避免URL查询参数
        route_generator: sylius.route_generator.locale_switcher.url_based  # 基于URL生成切换链接

3. 语言切换器模板适配 #

确保模板生成的切换链接符合无前缀/带前缀规则，使用Sylius内置的路由参数拼接逻辑：

{% for locale in sylius_available_locales %}
    <a href="{{ path(app.request.get('_route'), app.request.get('_route_params')|merge({'_locale': locale.code})) }}">
        {{ locale.name }}
    </a>
{% endfor %}

二、重定向循环问题排查 #

1. 路由规则冲突：务必限制sylius_shop_default_locale仅匹配二级语言前缀，否则无前缀的默认语言请求会被强制重定向，触发循环。
2. 自定义Locale服务优先级：如果使用自定义RequestLocaleContext或LocaleSubscriber，需确保服务优先级低于Sylius默认服务，避免提前修改请求locale导致循环：

# config/services.yaml
App\Locale\LocaleSubscriber:
    tags:
        - { name: kernel.event_subscriber, priority: 100 }  # 优先级低于Sylius默认订阅器

3. 缓存强制刷新：每次修改配置后执行bin/console cache:clear --env=dev，确保路由和配置完全生效。

三、配置验证 #

• 访问根路径/：直接加载英语店铺首页，无重定向
• 访问/nl/：正常加载荷兰语店铺首页
• 语言切换：切换器生成的英语链接为/，荷兰语链接为/nl/，无?_locale=查询参数

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