Class "MyFormType" not found主因是命名空间、路径或配置不匹配：类须置于src/Form/，命名空间为App\Form\，类名以Type结尾，PHP 8.1+需#[AsFormType]属性，改后须执行php bin/console cache:clear。
表单类找不到？检查命名空间和自动加载路径
运行 $this->createForm(MyFormType::class) 报 Class "MyFormType" not found，90% 是因为类没被 Autoloader 找到。Symfony 不会扫描任意目录，它只认标准路径和命名规范。
- 表单类必须放在
src/Form/目录下（不是src/Controller/或src/Entity/） - 类名必须以
Type结尾，例如UserRegistrationType - 命名空间必须是
App\Form\，不能漏掉App\前缀 - PHP 8.1+ 必须加
#[AsFormType]属性，否则容器可能忽略该类 - 改完后清缓存：
php bin/console cache:clear，否则旧的 autoloader 映射可能还在生效
表单提交后 $form->isValid() 总是 false？查字段映射和验证约束位置
表单能渲染、能接收数据，但 $form->isValid() 返回 false，且没错误提示——这通常不是代码写错了，而是验证规则“挂错地方”了。
- 字段名必须和目标对象属性名一致；若用
property_path（如property_path: "profile.phone"），确保嵌套对象已初始化，否则会直接跳过验证 - 验证约束优先写在实体类上（
#[Assert\Email]），而不是add()的 options 里；后者只在表单层生效，不参与 Doctrine 持久化前的校验 - 日期字段务必设
widget: 'single_text'并显式指定format，例如'yyyy-MM-dd'，否则浏览器传2026-05-15，PHP 可能按默认时区解析失败 - 如果用了
validation_groups，确保控制器中调用createForm()时传入了对应分组，否则约束根本不触发
消息总线（Messenger）发消息不进队列？看 routing 和 transport 是否匹配
dispatch(new SendEmailNotification()) 后消息直接执行、没进 Redis 或数据库队列？这不是代码没写对，而是配置没对齐。
- 先确认
messenger.yaml中定义了 transport，比如async: '%env(MESSENGER_TRANSPORT_DSN)%'，且环境变量已正确设置 - routing 规则必须精确匹配消息类的完整类名，例如
'App\Message\SendEmailNotification': async；写成'SendEmailNotification': async或'App\Message\*': async在 6.4+ 默认不生效（需显式启用通配符支持） - 未匹配任何 routing 的消息，默认走
sync://，也就是同步执行——这是设计行为，不是 bug - 用
php bin/console debug:messenger查看实际绑定关系，比猜更可靠
自定义验证器里加错误不显示？别漏掉 atPath() 和 buildViolation()
写了 ValidPasswordValidator，buildViolation() 也调了，但表单字段下没红字提示——大概率是错误没挂到对应字段上。
立即学习“PHP免费学习笔记（深入）”；
-
buildViolation()后必须接atPath('password')（字段名），否则错误默认挂在整个表单根对象上，Twig 模板里{{ form_errors(form.password) }}就看不到 - 嵌套字段用点号路径，例如
atPath('profile.email')，前提是profile是实体里的关联对象属性 - 不要手动 new
ExecutionContext，它由框架注入；在validate()方法第二参数里直接用$this->context - 如果想复用已有约束逻辑，优先组合内置约束（如
Compound），而非重复手写buildViolation
组件不是开箱即用的魔法盒，每个环节（类加载、路由匹配、上下文绑定）都依赖显式约定。漏掉一个 #[AsFormType]、少写一个 atPath()、或 routing 键名多一个空格，都会让整条链路静默失败——而这恰恰是 Symfony 在 2026 年依然要求开发者“读文档、看 debug 输出、信配置而非直觉”的原因。
