Symfony嵌入表单需显式配置级联保存、集合操作策略、嵌套验证及data_class匹配，否则出现NULL关联、误删数据、验证错误不显示或绑定失败。
嵌入子表单时 EntityType 不触发级联保存
默认情况下，Symfony 的 EntityType 字段只负责选择已有实体，不会自动新建或持久化新对象——哪怕你绑定了一个全新实体实例。这是最常被误解的点：以为“绑了对象就等于能存”，结果数据库里关联字段为 NULL 或报 ConstraintViolation。
必须显式开启级联操作：
-
cascade={"persist"}是基础，否则 Doctrine 不知道要保存嵌入的新对象 - 如果子对象有自己关联，还需补上
"remove"或"merge"（按需） - 别漏掉实体类上的
@ORM\JoinColumn(onDelete="CASCADE")，否则外键约束可能拦住删除
示例：在 Post 实体中嵌入 Author，需在 $author 属性上加 @ORM\ManyToOne(cascade={"persist"})。
CollectionType 嵌入一对多时，前端提交空数组导致子项全删
用户删掉所有子表单项、提交空 collection，Symfony 默认会把整个集合清空（clear()），连带数据库里已存在的记录也被删掉——这不是 bug，是设计行为。
控制策略取决于业务逻辑：
- 若允许“清空集合”，确保 Doctrine 映射中设置了
orphanRemoval=true，否则会报错 - 若禁止清空，用
allow_delete=false+allow_add=false锁死操作 - 更常见的是“保留旧项、仅更新/新增”，这时应在表单类型中禁用
by_reference=false，并手动在PreSubmit事件里过滤空数据
关键检查点：CollectionType 的 entry_type 必须是独立表单类型（如 TagType::class），不能直接用 TextType —— 否则 Doctrine 找不到对应实体映射。
嵌入表单后验证失败，错误不显示在子字段而堆在根表单
常见现象：子对象的 @Assert\NotBlank 触发了，但错误出现在父表单顶部，而不是对应输入框下方。根本原因是没启用嵌套验证传播。
两处必须同时配置：
- 在父表单的
buildForm()中，对嵌入字段调用$builder->add('author', AuthorType::class, ['constraints' => [new Valid()]]) - 在子表单类（如
AuthorType）的configureOptions()里，确保$resolver->setDefaults(['validation_groups' => 'Default'])没被意外覆盖
如果子实体用了自定义验证组，父表单也得同步传进去，否则 Valid 约束压根不生效。
使用 createNamedBuilder 动态嵌入时，data_class 冲突导致表单无法绑定
当在控制器里用 $form = $this->createFormBuilder($post)->createNamed('author', AuthorType::class) 这类方式手动嵌入，容易忽略：子表单的 data_class 必须与传入的数据实例严格匹配，且不能和父表单同名。
典型错误：
- 传入一个新
Author()，但AuthorType的data_class设成了App\Entity\User（继承关系也不行） - 父表单和子表单都设了
data_class=Post::class，Symfony 会拒绝绑定，抛出UnexpectedTypeException - 动态创建时忘了调用
getForm()，直接 render 导致表单无name属性，POST 数据无法映射
调试技巧：dump $form->getData() 和 $form->getErrors(true)，比看模板渲染结果更快定位绑定断裂点。
复杂点永远在数据流向的衔接处：实体状态、表单配置、验证链、Doctrine 生命周期监听器——任一环没对齐，嵌入就变成“看似运行，实则静默失效”。
