控制器类名必须以Controller结尾且方法名以Action后缀，命名空间须严格匹配PSR-4路径；Symfony默认依赖此规则进行路由匹配与服务注入，违反将导致Class not found或RouteNotFoundException。
控制器类名必须以Controller结尾
Symfony 会通过类名后缀自动识别控制器，不加 Controller 后缀会导致路由无法匹配或服务注入失败。这不是约定，而是框架硬性扫描逻辑——Kernel::getBundleControllers() 和路由编译器都依赖该命名模式。
- ✅ 正确：
ProductController、UserAdminController - ❌ 错误：
Product、UserAdmin、UserControllerClass
注意：不能只靠文件名判断；类声明里的 class ProductController 才是关键。即使文件叫 Product.php，只要类名是 ProductController 就合法。
控制器方法名必须以Action后缀
这是 Symfony 2–6 的标准调用契约。路由最终解析到的可执行单元，是带 Action 后缀的 public 方法。没有这个后缀，即使方法存在，也会被忽略或抛出 NotFoundHttpException。
- ✅ 正确：
indexAction()、editAction($id)、deleteAction(Request $request) - ❌ 错误：
index()、handleEdit()、processDelete()
从 Symfony 6.4 开始，Action 后缀已非强制（可通过配置启用“无后缀”模式），但默认仍启用且绝大多数项目未切换。盲目去掉后缀会导致现有路由全部失效。
命名空间和目录结构要严格匹配 PSR-4
控制器类的命名空间必须与 src/ 下的物理路径一致，否则 composer dump-autoload 不会注册它，运行时直接报 Class not found。
- 控制器文件路径：
src/Controller/ProductController.php - 对应命名空间必须是：
AppController（不是AppSrcController或AppControllers） - 类声明开头必须是：
namespace AppController;
常见坑：有人把控制器放在 src/Controllers/（复数），但 composer.json 中 autoload 配置写的是 "App\": "src/"，结果类加载器永远找不到 AppControllersProductController——因为命名空间里多了一个 s。
路由命名和控制器方法无关，但建议保持语义一致
路由名（如 app_product_index）由 @Route(name="...") 或 YAML 定义，不继承方法名。但混用命名风格会让调试和日志排查变困难。
- 推荐：
indexAction()对应路由名app_product_index - 不推荐：
listAction()对应app_product_show，或用驼峰式路由名如productList
真正容易被忽略的是：当控制器拆分成多个小类（如 ProductReadController、ProductWriteController）时，很多人忘了同步更新路由 name 前缀，导致 url() 或 generateUrl() 调用失败——错误信息里根本不会提示“路由名不存在”，只会报 RouteNotFoundException，而你得手动翻所有 annotations 或 routes.yaml 才能定位。
