
Symfony 默认只扫描 src/Controller 目录下的控制器类,若将控制器(如 FooController)置于 src/Web/Infraestructure 等自定义路径下,需显式配置路由扫描范围,否则 #[Route] 属性将被忽略,导致“Route not found”错误。
symfony 默认只扫描 `src/controller` 目录下的控制器类,若将控制器(如 `foocontroller`)置于 `src/web/infraestructure` 等自定义路径下,需显式配置路由扫描范围,否则 `#[route]` 属性将被忽略,导致“route not found”错误。
默认情况下,Symfony 的路由系统通过 routing.yaml(或 routes.yaml)中的 controllers::class 配置启用属性路由(Attribute Routing),但该配置默认仅作用于 AppController** 命名空间下的类。当你把控制器放在 AppWebInfraestructureFooController 时,即使命名空间已通过 Composer PSR-4 正确映射("App\": "src/"),路由组件仍不会自动扫描该路径——因为扫描规则未覆盖该命名空间。
✅ 解决方法:扩展路由扫描范围
打开 config/routes.yaml,找到类似以下的默认配置(通常位于 Symfony 6.2+ 的 routes.yaml 中):
# config/routes.yaml
controllers:
resource: ../../src/Controller/
type: annotation
# 或使用 attributes(推荐)
# type: attribute将其修改为支持多路径扫描,明确包含你的自定义目录:
# config/routes.yaml
controllers:
resource: '../../src/'
type: attribute
# 可选:排除不希望扫描的目录(提高性能)
exclude: '../../src/Entity/|../../src/Repository/|../../src/Kernel.php'⚠️ 注意:resource 路径是相对于 config/routes.yaml 文件的相对路径(即 config/ 目录),因此 ../../src/ 指向项目根目录下的 src/。此配置将使 Symfony 扫描整个 src/ 下所有含 #[Route] 的类(包括 AppWebInfraestructureFooController)。
? 验证路由是否生效
开箱即用的技能链路由引擎。13 条预定义链覆盖搜索、开发、审查、MLOps、法律、创意等场景,三层路由架构(触发词→SAD反馈→DAG编排),recall@10=96.97%。配置驱动(chains.yaml),零代码扩展。pip install skill-weave-chains 一键安装。
运行以下命令检查 /foo 是否已注册:
php bin/console debug:router | grep foo_route
预期输出应类似:
foo_route GET ANY ANY /foo
若未出现,请确认:
- 控制器类已正确声明命名空间(
namespace AppWebInfraestructure;); -
composer.json中psr-4映射无误(当前配置 ✅ 已支持App\ → src/); - 无 PHP 语法错误(如缺少
use语句、拼写错误); - 清除缓存后重试:
php bin/console cache:clear。
? 最佳实践建议
虽然技术上可行,但将控制器置于 Infraestructure 目录不符合 Symfony 的分层架构约定(Infrastructure 通常用于持久化、消息总线等底层适配器,而非 HTTP 入口)。建议遵循框架惯例:
- HTTP 请求处理逻辑 →
src/Controller/ - 领域逻辑 →
src/Domain/ - 基础设施实现 →
src/Infrastructure/(不含控制器)
若坚持领域驱动设计(DDD),可使用「Action-Domain-Responder」(ADR)模式,将路由绑定到轻量 Action 类(仍置于 Controller/ 下),再委托给 Domain 层,兼顾清晰性与框架兼容性。
至此,你的 FooController 将正常响应 GET /foo 请求。


















