Symfony 6注解路由配置后无法生效问题咨询

自定义注解路由未注册，通常由以下几种原因导致，按出现概率从高到低排查即可：

• 缺少注解路由依赖
  Symfony 6 最小化安装默认不自带Doctrine注解支持，仅原生支持PHP 8 Attributes路由写法，你代码中使用的@Route属于Doctrine注解格式，需要先安装对应依赖：

composer require doctrine/annotations

• 路由加载配置错误
  检查config/routes/annotations.yaml（若不存在则检查config/routes.yaml），确认存在指向控制器目录的注解加载规则，正确配置如下：

controllers:
    resource: ../src/Controller/
    type: annotation

注意：如果后续你切换为PHP 8原生Attributes写法，需要把type值改为attribute，当前使用@Route注解时必须保持type: annotation

• 文件路径/命名空间不符合PSR-4自动加载规则
  Homestead基于Linux系统，文件名大小写敏感，需要确认：

  • 控制器文件路径为src/Controller/BlogController.php，文件名和类名BlogController大小写完全一致
  • 控制器命名空间为App\Controller开头，和代码中声明的命名空间匹配
  • 路由对应的控制器方法为public公共方法（你当前代码的index方法符合要求，若后续修改方法可见性为private/protected会导致路由无法加载）

• 缓存未生效/权限异常
  完成上述修改后执行缓存清除命令，若命令执行失败可手动删除var/cache目录下的所有文件：

php bin/console cache:clear

如果是权限问题导致无法读取控制器文件，在项目根目录执行权限修复命令：

chown -R vagrant:vagrant .
chmod -R 755 src/ config/ var/

全部操作完成后重新执行php bin/console debug:router，即可看到注册成功的blog_index路由。

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