Symfony 6.1升级6.2后sensio/framework-extra-bundle弃用路由失效解决方案

删除sensio/framework-extra-bundle后路由失效，核心原因是该包的注解功能已被Symfony原生组件替代，你需要将原依赖该包的注解替换为Symfony官方实现，并确保原生注解支持已启用。

步骤1：启用Symfony原生注解支持 #

确保config/packages/framework.yaml中已开启注解控制器支持：

framework:
    router:
        annotated_controller:
            enabled: true

步骤2：替换所有Sensio注解为Symfony原生注解 #

逐个检查控制器文件，替换以下常见注解：

• 路由注解：
  原代码：

  use Sensio\Bundle\FrameworkExtraBundle\Configuration\Route;
  
  /**
   * @Route("/example")
   */
  

  替换为：

  use Symfony\Component\Routing\Annotation\Route;
  
  /**
   * @Route("/example")
   */
  // 或使用PHP 8+属性写法（推荐）
  #[Route("/example")]
  

• 参数转换注解（@ParamConverter）：
  原代码：

  use Sensio\Bundle\FrameworkExtraBundle\Configuration\ParamConverter;
  
  /**
   * @ParamConverter("post", class="App\Entity\Post")
   */
  public function show(Post $post) {}
  

  替换为Symfony原生的实体映射属性：

  use Symfony\Component\HttpKernel\Attribute\MapEntity;
  
  public function show(#[MapEntity] Post $post) {}
  

  注：多数情况下，Symfony会自动通过类型提示识别实体，无需额外注解，仅当需要自定义查询条件时才需使用#[MapEntity]

• 模板注解（@Template）：
  原代码：

  use Sensio\Bundle\FrameworkExtraBundle\Configuration\Template;
  
  /**
   * @Template("example/index.html.twig")
   */
  public function index() {}
  

  替换为直接返回模板路径或渲染结果：

  public function index(): Response
  {
      // 方式1：直接返回模板字符串，Symfony自动渲染
      return $this->render('example/index.html.twig');
  
      // 方式2：若需传递变量
      return $this->render('example/index.html.twig', [
          'data' => $data,
      ]);
  }
  

• 权限控制注解（@Security）：
  原代码：

  use Sensio\Bundle\FrameworkExtraBundle\Configuration\Security;
  
  /**
   * @Security("is_granted('ROLE_ADMIN')")
   */
  

  替换为：

  use Symfony\Component\Security\Http\Attribute\IsGranted;
  
  /**
   * @IsGranted("ROLE_ADMIN")
   */
  // 或PHP 8+属性写法
  #[IsGranted("ROLE_ADMIN")]
  

步骤3：清理缓存 #

执行缓存清理命令，确保新注解被系统识别：

php bin/console cache:clear

步骤4：验证路由配置 #

检查config/routes/annotations.yaml（或对应路由配置文件）是否正确指向控制器目录：

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

完成以上步骤后，重新启动应用，路由即可恢复正常。

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