如何对无需直接持久化的表单字段使用Symfony数据映射器

问题根因 #

该异常并非自定义映射逻辑错误，是Symfony表单组件默认行为导致：

• 所有通过add()方法添加的表单字段，默认mapped配置项为true，表单组件会在自定义数据映射逻辑执行前后，自动尝试将字段值写入/读取自绑定的根实体（即当前场景下的Event实体）
• 你尝试在mapFormsToData()循环中调用remove()删除字段的操作不生效：传入方法的$forms是预先生成的字段集合副本，修改父表单的字段结构不会改变已经传入方法的迭代集合，表单组件依然会执行默认的title字段映射逻辑，而Event实体没有title属性/对应public访问方法，就会抛出NoSuchPropertyException。

修复步骤 #

不需要新增表单类型、不需要修改字段名、不需要改动DataMapper接口签名，仅需两步调整：

• 给两个字段添加mapped => false配置，关闭默认自动映射，让这两个字段完全交给自定义数据映射器处理
  修改EventFormType代码如下：

public function buildForm(FormBuilderInterface $builder, array $options): void
{
    // ...其他原有逻辑

    $builder
        ->add('title', TextType::class, [
            'mapped' => false,
        ])
        ->add('description', TextareaType::class, [
            'mapped' => false,
        ])
        ->setDataMapper(new EventDataMapper())
    ;
}

• 删除mapFormsToData()中所有调用$form->getParent()->remove()的冗余代码，调整后逻辑如下：

public function mapFormsToData($forms, &$data): void
{
    // ...其他原有逻辑

    foreach ($forms as $element => $form) {
        switch ($form->getConfig()->getName()) {
            case 'title':
                $this->mapTitleFormToData($form, $element, $data);
                break;
            case 'description':
                $this->mapDescriptionFormToData($form, $element, $data);
                break;
        }
    }
    $this->mapTitleAndDescriptionFieldsToEventDetailsData($data, $forms);
}

方案兼容性说明 #

• 字段名、表单类型完全保留原有实现，前端渲染的表单结构、提交的参数名没有任何变化，不会影响团队其他成员的现有代码
• mapped=false仅关闭表单组件的默认自动属性映射，字段依然会正常渲染、正常接收提交值、支持数据回显，你在自定义数据映射器中可以正常读取、处理字段值
• 完全符合Symfony Form DataMapperInterface规范，不会出现接口签名不兼容的致命错误

内容的提问来源于stack exchange，提问作者Mayor of the Plattenbaus