控制器文件必须放在src/Controller/目录下，因Symfony默认仅从此路径按PSR-4映射自动加载，路径、命名空间与composer.json配置须严格一致，否则报Class not found。
控制器文件必须放在 src/Controller/ 目录下
Symfony 默认只从 src/Controller/ 自动加载控制器类，这是由框架约定和 composer.json 中的 PSR-4 映射共同决定的。如果你把控制器放到 src/Utils/Controller/ 或 app/Controller/ 这类非标准路径，即使命名空间写对了，php bin/console make:controller 生成的类也不会被自动识别，运行时直接报 Class "AppControllerXXX" not found。
常见错误现象：
- 手动新建
src/MyBundle/Controller/并写类，但没改composer.json的 autoload 配置 → 类无法加载 - 用
make:controller FooController但终端提示 “Command ‘make:controller’ is not defined” → 没装symfony/maker-bundle，不是路径问题
make:controller 命令默认只生成到 src/Controller/
执行 php bin/console make:controller ArticleController 后，文件一定落在 src/Controller/ArticleController.php，且命名空间固定为 AppController。你不能通过参数指定其他目录 —— 它不支持 --dir 或类似选项。
如果你想组织得更细（比如分 Admin / Api / Front），可行做法是：
- 保持目录仍是
src/Controller/，但用子目录：如src/Controller/Admin/UserController.php，对应命名空间AppControllerAdmin - 在
composer.json中补一条 PSR-4 映射："App\Controller\Admin\": "src/Controller/Admin/"，然后运行composer dump-autoload - 路由配置里用
resource: '../../src/Controller/Admin/'导入，避免单个 YAML 文件过大
控制器类名和命名空间必须严格匹配路径
这是最容易被忽略的硬性规则。例如：
- 文件
src/Controller/Api/UserController.php→ 命名空间必须是AppControllerApi，不能是AppController或AppApiController - 类名必须以
Controller结尾（如UserController），否则make:controller不会把它当控制器处理，路由注解也不生效 - 移动已有控制器文件后，必须立刻运行
composer dump-autoload，否则旧的 autoloader 缓存仍指向原路径
路由能“找到”控制器，不等于它真在 src/Controller/
你可以用 YAML 路由手动绑定任意可调用对象，比如：
example:
path: /test
controller: AppServiceSomeService::handle
但这不属于 Symfony 的“控制器”概念范畴 —— 它绕过了控制器生命周期、不支持 @Route 注解、不会被 make:controller 管理，也不享受 AbstractController 提供的 helper 方法（如 $this->render()）。日常开发中应避免这种用法，除非有明确架构约束。
真正需要关注的边界是：只要走标准流程（make:controller、注解路由、AbstractController 继承），路径、命名空间、PSR-4 映射这三者就一个都不能松动。
