Symfony无法加载资源：清理缓存或访问端点时报错

问题描述 #

清理缓存或访问端点时，Symfony抛出错误：

Cannot load resource "{\"name\":\"Applicant\",\"path\":\"%kernel.project_dir%/src/Applicant/UI/Action/V1/\",\"namespace\":\"App\\Applicant\\UI\\Action\\V1\",\"type\":\"attribute\"}"

错误原因 #

routes.yaml中路由配置格式错误：将resource设置为嵌套数组，Symfony无法识别这种结构。正确的做法是resource直接指向控制器目录路径，type、namespace等参数作为路由节点的同级配置项。

解决方案 #

1. 修正routes.yaml配置 #

将原配置修改为：

controllers:
  resource: '../src/Applicant/UI/Action/V1/'
  type: attribute
  namespace: App\Applicant\UI\Action\V1
  name: Applicant

api_login_check:
  path: /api/login_check

2. 清理缓存 #

执行缓存清理命令：

# 开发环境
php bin/console cache:clear

# 生产环境
php bin/console cache:clear --env=prod

3. 验证路由加载 #

运行命令查看路由是否成功加载：

php bin/console debug:router

确认输出中存在api.v1.registration路由。

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