表单动态添加字段必须在PRE_SUBMIT或PRE_SET_DATA事件中通过$form->add()实现，否则字段不生效、验证失效或提交报错；命名需符合Symfony嵌套规则，约束须手动配置。
表单提交后字段消失？没触发 PRE_SUBMIT 事件
动态添加字段必须在表单“构建完成但尚未处理提交数据”前介入，否则新字段根本不会被解析。最常踩的坑是把逻辑放在 POST_SET_DATA 或 BUILD_FORM 里——前者太晚（数据已绑定），后者太早（$options['data'] 可能为空，无法判断条件）。
正确时机只有两个：PRE_SUBMIT（处理原始请求数据时）和 PRE_SET_DATA（准备展示数据时）。动态加字段通常要兼顾两者：
-
PRE_SET_DATA：根据已有数据决定加哪些字段（比如编辑页面回显） -
PRE_SUBMIT：根据用户提交的原始数组（如$_POST）决定加哪些字段（比如前端 JS 动态增行后提交）
漏掉任意一个，就会出现“页面显示了字段，但提交后报错 This form should not contain extra fields”或“字段值不保存”。
add() 调用后字段不生效？忘了传 $builder->getForm()->getConfig()
在事件回调里不能直接调用 $builder->add()，因为此时 $builder 是当前表单类型的独立实例，不是最终渲染的表单构建器。错误写法：$builder->add('dynamic_field', TextType::class) —— 这个字段只会出现在“子表单类型定义里”，不会进入实际表单树。
必须通过事件参数拿到顶层构建器：
use Symfony\Component\Form\FormEvent;
$builder->addEventListener(FormEvents::PRE_SUBMIT, function (FormEvent $event) {
$form = $event->getForm(); // ← 关键：拿到正在处理的表单实例
$data = $event->getData();
if (!empty($data['has_extra'])) {
$form->add('extra_note', TextType::class);
}
});
注意：$form->add() 才是对的；$builder->add() 是错的。很多教程混淆了表单类型类和运行时表单实例。
JavaScript 增加字段后提交报 Expected argument of type "array", "string" given
这是 Symfony 表单对嵌套字段（如集合）的典型校验失败。前端用 JS 动态添加字段时，如果没按 Symfony 的命名规则生成 name 属性，后端解析就会崩。
例如集合字段 tasks，Symfony 期望的 name 是：form[tasks][0][title]，而不是 form[tasks][title] 或 form[task_title]。
解决方案只有两个：
- 用
CollectionType+allow_add: true，配合官方推荐的 JS 模板机制（data-prototype） - 手动拼 name 时严格遵循
form[字段名][索引][子字段名]格式，且索引必须为数字、连续、从 0 开始
跳过索引或用随机字符串（如 form[tasks][abc123][title]）必然触发该错误。
动态字段验证不执行？constraints 没随字段一起加
用 $form->add() 添加字段时，如果不显式传入 constraints 选项，该字段就完全绕过验证，哪怕你在实体上写了 @Assert\NotBlank。
因为动态字段不对应实体属性，Symfony 不会自动映射注解约束。必须手动补上：
$form->add('phone_number', TelType::class, [
'constraints' => [
new NotBlank(['message' => '电话不能为空']),
new Regex(['pattern' => '/^1[3-9]\d{9}$/', 'message' => '手机号格式不正确']),
],
]);
另一个容易忽略的点：如果字段类型是 EntityType 或 ChoiceType，还要确认 choices 或 class 参数是否在运行时有效——比如数据库连接未初始化，会导致整个表单构建失败，错误堆栈可能藏得很深。
