Symfony 6.3.3（PHP8.1）路由未创建/识别问题求助

执行php bin/console debug:router仅返回_preview_error路由，访问/api/parties触发404错误（抛出Symfony\Component\Routing\Exception\ResourceNotFoundException），结合你给出的配置和代码，可从以下几点排查：

1. 注解路由组件未启用 #

Symfony的注解路由依赖annotations组件，先确认项目已安装：

composer require annotations

同时检查config/packages/framework.yaml里的路由配置，确保开启了注解加载：

framework:
    router:
        resource: '%kernel.project_dir%/config/routes.yaml'
        annotation_loader: true # Symfony 5+需配置此项

2. YAML路由配置缩进错误 #

YAML对缩进要求严格，你的routes.yaml里app_party下的resource和type必须用2个空格缩进（不能用制表符），缩进错误会导致路由规则不生效。正确格式如下：

app_party:
    resource: App\Controller\PartyController
    type: annotation

3. 缓存未清除 #

Symfony会缓存路由配置，修改注解或配置文件后必须清除缓存才会生效，执行对应环境的清缓存命令：

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

4. Controller注解或文件路径问题 #

虽然你代码里已引入Route注解，但要确认：

• 类上的/** @Route("/api/parties", name="app_party_api_parties") */注解块无语法错误（比如/**后缺星号、注释格式混乱）
• Controller文件确实在src/Controller/目录下，命名空间namespace App\Controller;、类名PartyController与文件名PartyController.php完全匹配（大小写敏感）

5. 路由冲突或覆盖 #

检查其他路由配置文件（比如routes/dev/下的文件）或其他Controller的注解，是否存在路径与/api/parties、/api/parties/add-sample重复的情况，路由冲突会导致目标路由无法被识别。

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