Symfony Form提交时FormEvents::SUBMIT将null转对象导致字段无法清空问题

问题根因 #

你遇到的问题是Symfony复合表单类型的默认行为导致的：当你提交null给配置了data_class的复合类型时，Symfony的SUBMIT事件会默认用empty_data配置项实例化一个对应类的空对象，不会直接传递null值，因此不会触发原有字段的清空逻辑。

修复步骤 #

1. 修改NameType的默认配置，指定empty_data为null
   在NameType的configureOptions方法中新增empty_data配置，覆盖默认的实例化逻辑：

public function configureOptions(OptionsResolver $resolver)
{
    $resolver->setDefaults([
        'data_class' => Name::class,
        'compound' => true,
        'empty_data' => null, // 新增这一行，提交null时直接返回null而不是实例化对象
    ]);
}

2. 配置name字段的by_reference为false
   在PersonType中声明name字段时，设置by_reference为false，确保表单组件会主动调用Person实体的setName方法，把null值写入实体：

$builder
    ->add('name', NameType::class, [
        'by_reference' => false, // 新增配置
    ])
;

3. 检查NameTransformer的null值处理逻辑
   确保你的NameTransformer的reverseTransform方法兼容null输入，直接返回null即可：

// NameTransformer类中的reverseTransform方法示例
public function reverseTransform($value)
{
    if (null === $value) {
        return null;
    }
    // 原有转换逻辑
}

验证 #

修改完成后再提交"name": null的请求，表单会直接把null值传递给Person实体的setName方法，即可完成字段清空。

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