Symfony嵌套表单需显式配置级联保存、验证传播、选项透传等，否则子字段错误不显示、关联数据存不进库、验证堆顶层或逻辑失效；基本写法是在buildForm中add子表单类型，并确保@Assert\Valid()、constraints=[new Valid()]及configureOptions正确设置。
Symfony嵌套表单不是自动“连通”的，得靠显式配置才能让父子表单协作正常——包括数据绑定、验证传播、级联保存和自定义选项透传。写错一个环节，就容易出现子字段不显示错误、关联数据存不进数据库、验证失败堆在顶层、或自定义逻辑不生效等问题。
嵌入子表单的基本写法
用 add() 方法嵌入另一个表单类型，是最常见方式：
- 在父表单的
buildForm()中调用$builder->add('field_name', ChildType::class, [...]) - 子表单类（如
AddressType）需继承AbstractType，并实现configureOptions()和buildForm() - 若子表单对应实体属性，确保父实体中该属性有正确 getter/setter，且 Doctrine 映射无误（如
@ORM\ManyToOne或@ORM\OneToMany）
让子表单验证错误显示在对应字段下
默认情况下，子对象的验证错误不会自动定位到子输入框，必须启用递归验证：
- 在父实体对应属性上加
@Assert\Valid()注解（例如private Address $address;） - 在父表单
add()调用中，显式传入'constraints' => [new Valid()] - 子表单类的
configureOptions()中不要覆盖validation_groups默认值，除非你同步在父表单里也传了相同组名
传递自定义选项给子表单
Symfony 不会自动把父表单的 $options 传给子表单，必须手动透传：
- 在父表单
add()的第三个参数（选项数组）中，逐个写明要传的键值对，例如：['show_help' => $options['show_help'], 'units' => $options['units']] - 子表单类的
configureOptions()中，用$resolver->setDefaults([...])声明这些选项并设默认值，否则运行时报错 - 避免直接用
$options全量透传，只传真正需要的，防止意外覆盖子表单内部逻辑
处理一对多集合（如多个电话号码）
用 CollectionType 嵌入一组子表单，关键在控制行为边界：
-
entry_type必须是完整表单类型（如PhoneType::class），不能是基础字段类型（如TextType::class） - 想默认带两个空条目？在控制器里先向集合属性 push 两个新实例，再传给表单
- 提交空数组时是否清空数据库记录？取决于
orphanRemoval=true和cascade={"remove"}的组合配置，按业务决定是否开启
