Symfony 7控制器必须继承AbstractController或实现ControllerInterface，嵌入框架生命周期，否则路由、依赖注入和响应均失效；@Route需配合启用的注解路由配置，命名路由为URL生成前提；数据操作须交由服务或仓储，视图渲染必须用render()或显式返回Response。
Symfony 7 的控制器不是“写完就能跑”的裸函数，它必须嵌入在框架的请求-响应生命周期里，否则 Response 不会被正确发送，路由不会生效，依赖注入也会失效。
控制器必须继承 AbstractController 或实现 ControllerInterface
直接写一个普通类加 @Route 注解是无效的。Symfony 7 要求控制器具备框架上下文感知能力，比如能调用 $this->render()、$this->getDoctrine() 或获取请求对象。
-
AbstractController提供了开箱即用的快捷方法（render()、redirectToRoute()、json()等），适合绝大多数场景 - 若需极简控制（如纯 API 响应且不依赖任何服务），可手动实现
ControllerInterface，但要自行处理Request注入和返回Response实例 - 使用
make:controller命令生成的类默认继承AbstractController，不要手动删掉extends
@Route 注解必须配合路由加载器启用
Symfony 7 默认启用注解路由，但前提是 config/routes.yaml 中存在对应配置。常见错误是删掉了这行：
controllers:
resource: ../../src/Controller/
type: annotation
没有它，@Route 就只是注释，不会注册任何路由。
- 路径中
../../src/Controller/是相对路径，必须与实际目录结构一致；改过目录名（如src/Controllers/）就得同步更新 - 如果用 PHP 配置（
routes.php），注解路由不会自动启用，必须显式调用AnnotationDirectoryLoader -
@Route的name参数不是可选的——命名路由是生成 URL（$this->generateUrl()）和测试路由匹配的前提
模型层不能在控制器里直接 new 实体或写 SQL
控制器只负责协调，不负责数据操作。把 new User() 或 mysqli_query() 放进控制器，会破坏可测试性、无法复用、绕过 Doctrine 生命周期和事件机制。
- 实体（
App\Entity\User）只定义结构和简单业务方法，不包含数据库逻辑 - 查数据走仓储（
$this->getDoctrine()->getRepository(User::class)）或自定义仓储方法 - 写业务逻辑封装进服务（
App\Service\UserRegistrationService），通过构造函数或属性注入到控制器 - Doctrine 的
EntityManagerInterface不能直接在控制器里persist()/flush()—— 这属于服务或仓储职责
视图渲染必须用 render() 或显式返回 Response
Twig 模板不是自动加载的。返回字符串、数组或 void 都不会触发渲染，HTTP 响应体将为空或报错。
-
return $this->render('example/index.html.twig', ['name' => 'Alice']);是标准做法，render()自动创建Response并设置 Content-Type - 返回 JSON 接口时用
return $this->json(['status' => 'ok']);，它等价于new JsonResponse(...)，比手动json_encode()+Response更安全（自动设 header、处理 null） - 若用原生
Response，必须确保内容类型正确：return new Response('Hello', 200, ['Content-Type' => 'text/plain']) - 模板路径
example/index.html.twig对应templates/example/index.html.twig，漏掉.html.twig后缀会导致“template not found”错误
最容易被忽略的是控制器方法签名：Symfony 7 要求明确声明返回类型（: Response），且不能返回 null；同时，所有依赖都必须通过构造函数注入，而不是在方法体内用 $this->container->get() —— 后者在 Symfony 6+ 已弃用且破坏类型安全。
