Symfony 5.3.9项目如何为routes.php中的路由添加多语言前缀

问题根因梳理 #

你遇到的报错和前缀重复问题主要来自三个错误点：

1. 注解路由配置存在笔误，默认locale参数名写错
2. routes.php 路由没有统一绑定_locale前缀规则，硬编码路径和重定向逻辑冲突
3. 路由优先级顺序不对，重定向时用硬编码路径而非路由名生成链接

分步修复方案 #

1. 修正注解路由配置笔误 #

打开/config/routes/annotations.yaml，修正默认参数名：

controllers:
  resource: ../../src/Controller/
  type: annotation
  prefix: /{_locale}
  requirements:
      _locale: en|fr|ar|nl
  defaults:
    _locale: 'en' # 原来的_locales多了个s，删除多余的s

2. 统一给routes.php路由加全局前缀 #

不需要在routes.php里逐个路由手动加{_locale}或者硬编码语言前缀，直接在/config/routes/routes.yaml里添加导入routes.php的配置，统一绑定前缀规则：

# 放在legacy路由配置前面，保证优先级
php_routes:
  resource: ../../routes.php
  prefix: /{_locale}
  requirements:
    _locale: en|fr|ar|nl
  defaults:
    _locale: 'en'

# 原有配置保持不变即可
legacy:
  resource: .
  type:     legacy
# 其余api、contact、app_index等配置不变

然后修改routes.php里的路由定义，删除手动加的前缀：

// 直接写原始路径即可，全局配置会自动加{_locale}前缀
$this->addRoute('activities', '/activities', 'ActivitiesController', 'activities');
$this->addRoute('activities_near_me', '/activities/nearme', 'ActivitiesController', 'activitiesNearMe');

3. 修复重定向逻辑，避免前缀重复 #

之前出现/en/en/前缀重复的问题，是因为你在ActivitiesController::activities方法里用了硬编码的路径跳转，改为用路由名生成跳转链接即可：

// 错误写法：硬编码路径会被自动拼接当前_locale前缀，导致重复
// return $this->redirect('/activities/nearme');

// 正确写法：用路由名生成链接，Symfony会自动携带当前_locale参数
return $this->redirectToRoute('activities_near_me');

4. 验证配置是否生效 #

执行命令查看路由配置：

php74 bin/console debug:router

确认activities和activities_near_me路由的路径为/{_locale}/activities和/{_locale}/activities/nearme即可。

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