Symfony表单提交后复合字段propertyValues数据为空问题

你遇到的核心问题是CollectionType字段的entry_type参数配置错误——你直接传入了PropertyValueDTO这个数据传输对象类，但Symfony的CollectionType要求entry_type必须是一个表单类型（继承AbstractType的类），而不是DTO本身。这就导致Symfony无法正确解析提交的propertyValues数据，最终这个字段变成空数组，甚至连Count约束都没生效（因为表单没有正确生成子字段来执行验证）。

下面是具体的修复步骤：

1. 创建对应的PropertyValue表单类型类 #

首先，你需要为PropertyValueDTO创建一个表单类型，用来定义这个子字段的结构：

// src/Form/PropertyValueFormType.php
namespace App\Form;

use App\DTO\Api\PropertyValueDTO;
use Symfony\Component\Form\AbstractType;
use Symfony\Component\Form\FormBuilderInterface;
use Symfony\Component\OptionsResolver\OptionsResolver;
use Symfony\Component\Form\Extension\Core\Type\TextType;
use Symfony\Component\Form\Extension\Core\Type\IntegerType;

class PropertyValueFormType extends AbstractType
{
    public function buildForm(FormBuilderInterface $builder, array $options)
    {
        $builder
            ->add('id', IntegerType::class)
            ->add('value', TextType::class)
            ->add('propertyId', IntegerType::class)
            ->add('productsCount', IntegerType::class)
        ;
    }

    public function configureOptions(OptionsResolver $resolver)
    {
        $resolver->setDefaults([
            'data_class' => PropertyValueDTO::class,
        ]);
    }
}

2. 修改PropertyForm中的CollectionType配置 #

把原来propertyValues字段的entry_type替换成刚才创建的PropertyValueFormType::class：

// src/Form/PropertyForm.php
class PropertyForm extends FormType {
    public function buildForm(FormBuilderInterface $builder, array $options) {
        parent::buildForm($builder, $options);
        $builder
            ->add('name', TextType::class)
            ->add('propertyValues', CollectionType::class, [
                'entry_type' => PropertyValueFormType::class, // 替换为表单类型类
                'required' => true,
                'constraints' => [
                    new Count(['min' => 1])
                ],
                'allow_add' => true, // 若需要动态添加子字段可开启，按需调整
            ])
        ;
    }

    public function configureOptions(OptionsResolver $resolver) {
        parent::configureOptions($resolver);
        $resolver
            ->setDefaults([
                'data_class' => PropertyDTO::class,
                'csrf_protection' => false, // API提交场景建议关闭CSRF保护
            ]);
    }
}

3. 检查DTO的getter/setter方法 #

确保PropertyDTO中的propertyValues属性有正确的读写方法，Symfony表单需要通过这些方法完成数据映射：

// src/DTO/Api/PropertyDTO.php
namespace App\DTO\Api;

class PropertyDTO
{
    // ... 其他属性定义
    private array $propertyValues = [];

    public function getPropertyValues(): array
    {
        return $this->propertyValues;
    }

    public function setPropertyValues(array $propertyValues): self
    {
        $this->propertyValues = $propertyValues;
        return $this;
    }
}

4. 控制器的小优化（可选） #

如果是API更新场景，提交表单时可以设置clearMissing: false，避免清空未提交的字段：

public function update(Property $property, Request $request) {
    $form = $this->createForm(PropertyForm::class);
    $data = json_decode($request->getContent(), true);
    // 第二个参数设为false，保留原始数据中未提交的字段
    $form->submit($data, false);
    
    if (!$form->isValid()) {
        return $this->jsonFormFailed($form);
    }
    
    return $this->jsonResponse($form->getData());
}

完成以上修改后，Symfony就能正确解析提交的propertyValues数据，并将其映射为PropertyValueDTO对象数组，你的propertyValues字段就不会再是空数组了。

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