直接运行 php bin/console make:controller 自动生成控制器类、模板目录和 index 方法，需先安装 symfony/maker-bundle；类名须以 Controller 结尾，模板路径按小写类名生成，不覆盖已有文件。
symfony console make:controller 命令怎么用
直接运行 php bin/console make:controller，它会提示你输入控制器类名（比如 BlogController），然后自动生成类文件、模板目录和一个默认的 index 方法。这个命令依赖 symfony/maker-bundle，如果没装，先 composer require --dev symfony/maker-bundle。
常见错误现象：Command "make:controller" is not defined —— 说明 maker bundle 没装或没启用；Class "App\Controller\XXXController" already exists —— 类名重复，注意大小写和命名空间是否冲突。
- 类名必须以
Controller结尾，否则生成器会报错或路由不识别 - 生成的模板路径默认是
templates/blog/index.html.twig，路径基于类名小写转换，不是文件名 - 该命令不会覆盖已有同名控制器，但会跳过已存在的方法（比如你手动加了
show()，再运行一次不会删它）
控制器里怎么定义新动作方法（action）
在控制器类里加一个 public 方法，方法名带 Action 后缀（如 showAction），Symfony 会自动把它当路由目标 —— 这是 Symfony 4.4+ 的默认约定。但更推荐不加后缀（如 show），配合注解或属性路由显式声明。
使用场景：新增页面、API 端点、表单提交处理。别把业务逻辑塞进 action 方法里，只做请求接收、参数提取、响应构造三件事。
- 方法必须是
public，否则路由匹配失败，报错Callable "App\Controller\BlogController::show() is not public - 返回值必须是
Response实例，直接return $this->render()或return new Response()都行 - 参数类型提示会触发自动注入，比如
Request $request、UserInterface $user（需 security bundle）
@Route 注解和 #[Route] 属性哪个该用
如果你项目 PHP 版本 ≥ 8.0，优先用 #[Route] 属性；否则用 @Route 注解。两者功能一致，但属性语法更简洁、IDE 支持更好、无额外依赖（注解需要 doctrine/annotations）。
性能影响几乎可忽略，但注解在每次请求时需反射解析，而属性在 PHP 8+ 编译期就可用 —— 对 CLI 命令或高频 API 影响微乎其微，不过新项目没必要倒退。
-
#[Route('/blog/{id}', name: 'blog_show')]是标准写法，name必须唯一，用于$this->generateUrl()或 Twig 中的{{ path('blog_show', {id: 1}) }} - 路径参数如
{id}默认是字符串，要约束类型得加requirements：#[Route('/blog/{id}', ...)] - 别在同一个方法上混用注解和属性，会导致路由注册失败，报错
Unable to parse route annotation
为什么访问 /xxx 报 404，但控制器明明存在
最常见原因是路由没加载或匹配规则不对。检查 config/routes.yaml 是否启用了 controller 自动发现（默认有 controllers: 块），或者确认你没删掉 kernel.php 里 ->import(...) 的那行。
另一个高频坑：开发环境缓存没清。改完路由或控制器后，执行 php bin/console cache:clear，别只信浏览器刷新。
- 运行
php bin/console debug:router查看所有已注册路由，确认你的路由名和路径是否在列表中 - 如果用了
#[IsGranted]或防火墙限制，404 可能是 403 被静默转成的，开 profiler 看真实状态码 - Apache 用户注意：确保
.htaccess或虚拟主机配置启用了AllowOverride All，否则重写规则不生效
路由匹配顺序、前缀嵌套、环境配置差异这些点，实际调试时比写法本身更耗时间。
