Symfony同实体多表单提交识别与校验异常排查

两个错位的实现共同导致了所有异常：

• Symfony表单组件的提交识别逻辑，是匹配请求参数中是否存在与表单命名空间一致的顶级键值，没有对应键的表单不会被判定为提交状态。但当前前端AJAX提交的是扁平结构参数，完全没有携带三个表单对应的专属命名键，导致Symfony无法区分请求归属，加上三个表单共用同一个实体实例，所有表单都把同一份请求数据当成自己的提交内容，依次触发isSubmitted()返回true。
• 因为form1是第一个执行handleRequest的，它会优先从请求中提取到usuario字段值，用自己配置的dpto=C的用户列表规则做校验，哪怕实际提交的是其他部门的合法用户ID，也会被form1判定为无效值抛出校验错误，后续form2、form3的校验逻辑反而不会执行到正确的分支。

1. 调整前端AJAX提交结构，匹配Symfony表单识别规则 #

Symfony表单正确的提交识别逻辑要求，每个表单提交时必须携带对应表单名称的顶级参数键。当前JS提交逻辑跳过了表单本身的序列化，手动拼接的扁平参数完全不符合识别要求，需要调整为嵌套匹配结构：

$('form').submit(function(e){
  e.preventDefault();
  const $currentForm = $(this);
  // 获取Twig中设置的表单名称，如responsavelContabil
  const formName = $currentForm.attr('name');
  // 提取当前表单内的usuario选择框值
  const usuarioId = $currentForm.find('select[name$="[usuario]"]').val();
  // 组装Symfony可识别的提交结构
  const submitData = {
    [formName]: {
      usuario: usuarioId
    },
    // 业务自定义参数放在外层，不影响表单识别
    dpto: $currentForm.find('select').attr('id').replace('usuario', '').charAt(0),
    cliente: $('#clienteId').data('cliente')
  };
  $.ajax({
    url: "{{ path('responsavel_index')}}",
    type: 'post',
    dataType: 'json',
    data: submitData,
    success: function(){
      console.log('foi');
    }
  });
});

调整后，只有参数中存在对应表单名顶级键的实例，isSubmitted()才会返回true，其他无匹配键的表单会直接跳过处理，不会出现全量误判的问题。

2. 为三个表单绑定独立实体实例，避免校验串扰 #

当前控制器中将同一个Responsavel实例共享给三个表单，是校验逻辑串扰的核心来源，需要为每个表单单独创建独立的实体对象：

// 删除原来的公共实体实例
// $responsavel = new Responsavel();

$form1 = $this->createForm(ResponsavelType::class, new Responsavel(), ['dpto' => 'C']);
$form1->remove('ativo');
$form1->remove('cliente');
$form1->remove('competenciaInicial');
$form1->handleRequest($request);

$form2 = $this->createForm(ResponsavelType::class, new Responsavel(), ['dpto' => 'D']);
$form2->remove('ativo');
$form2->remove('cliente');
$form2->remove('competenciaInicial');
$form2->handleRequest($request);

$form3 = $this->createForm(ResponsavelType::class, new Responsavel(), ['dpto' => 'F']);
$form3->remove('ativo');
$form3->remove('cliente');
$form3->remove('competenciaInicial');
$form3->handleRequest($request);

调整后，每个表单使用独立的实体对象、对应部门的用户列表规则做校验，不会出现form1优先拦截其他部门提交的合法用户ID的问题。

3. 配套调试技巧 #

修改完成后如果仍有识别异常，可以在控制器中添加调试代码快速定位问题：

dump([
  'form1_submitted' => $form1->isSubmitted(),
  'form2_submitted' => $form2->isSubmitted(),
  'form3_submitted' => $form3->isSubmitted(),
  'request_structure' => $request->request->all()
]);

重点检查request_structure中是否存在三个表单名对应的顶级键，没有匹配项就说明前端提交的结构仍有偏差。
额外注意：form2、form3的提交按钮缺少type="submit"属性，建议手动补上，避免非预期的表单触发行为。

内容的提问来源于stack exchange，提问作者Lucas Marques