CollectionType 表单提交后数据为空，因 by_reference 默认为 true，需设为 false 并确保 setter 存在；动态增删失败因 prototype name 不匹配；子实体验证需加 @Assert\Valid；删除失效因未配 orphanRemoval=true 或未手动 remove。
CollectionType 表单提交后数据为空？检查 by_reference 是否设为 false
默认情况下，CollectionType 的 by_reference 是 true，这意味着 Symfony 不调用父实体的 setter，而是直接操作集合对象本身。如果子实体没有正确初始化（比如 new ArrayCollection()），或者你依赖 setter 做额外逻辑（如自动设置关联、时间戳），数据就会“消失”。
实操建议：
- 在
CollectionType配置中显式写'by_reference' => false - 确保父实体的 setter 方法存在且接受单个子对象（例如
addTag(Tag $tag)和removeTag(Tag $tag)） - 子实体必须实现
__toString()或定义prototype_name，否则 JS 动态添加时字段名会出错
动态增删子表单项失败？Prototype 和 JS 里 name 属性不匹配
前端 JS 添加新行时，name 必须和 Symfony 渲染的 prototype 完全一致，否则提交后表单组件无法识别这些字段——它们会被忽略，也不进验证流程。
常见错误现象：
- 点击“添加”后输入内容，提交时新增项完全没进控制器
-
$form->get('tags')->getData()只返回原始项，不含 JS 新增的
实操建议：
- 用
{{ form_widget(form.tags) }}渲染时，确保模板里取的是form.tags.vars.prototype，不是手写的tags[__name__] - JS 中克隆 prototype 后，必须替换所有
__name__为递增索引（如tags[2]），且不能漏掉嵌套字段（如tags[2][name]、tags[2][id]） - 别用 jQuery 的
.attr('name')直接改——要遍历所有子 input/select/textarea 并更新它们的name和id
子实体验证不触发？忘了加 Valid 约束
CollectionType 默认不会递归验证子对象。即使你在子实体类上写了 @Assert\NotBlank，提交时也不会报错。
使用场景：用户必须填至少一个标签，且每个标签的 name 字段不能为空。
实操建议：
- 在父实体的集合属性上加
@Assert\Valid（注意是Valid，不是NotNull或Count） - 如果集合允许空（比如可选的附加信息），再补上
@Assert\Count(min=1)控制数量 - 验证错误会出现在子表单项对应字段下，而不是整个集合字段顶部——调试时要看
$form->get('tags')->getErrors()还是$form->get('tags')->get('0')->get('name')->getErrors()
删除已存在的子记录没生效？数据库级外键或生命周期监听器干扰
表单提交后，removeTag() 被调用了，但数据库里那条记录还在。这不是表单问题，而是 Doctrine 没执行 DELETE。
原因通常有两个：
- 子实体没配置
orphanRemoval=true（在@OneToMany注解或 YAML 映射里） - 父实体的
removeXxx()方法只从集合移除，没调用$entityManager->remove($child)，而 Doctrine 默认不自动级联删除
性能 / 兼容性影响：
- 开启
orphanRemoval=true后，Doctrine 会在 flush 时自动发 DELETE 语句，无需手动 remove - 但如果子实体被其他地方引用，启用
orphanRemoval可能导致意外删除——务必确认该关系确实是“拥有型”
容易被忽略的地方是：即使表单里勾了删除、PHP 层也清掉了集合，若没配 orphanRemoval 或没手动 remove()，那条记录就静静躺在数据库里，下次加载还会回来。
