Symfony5通过REST API保存oneToMany关联实体时prices字段验证失败问题

你错误使用了EntityType作为prices字段的表单类型：EntityType仅用于选择数据库中已存在的Price实体，会默认校验传入的参数是已存在的实体ID，你传入的是全新的价格属性数组，自然会触发校验失败。
另外你使用的NotNull约束仅校验集合对象本身是否存在，空集合也会通过校验，这就是传入空prices数组不会报错的原因。

1. 新增PriceType表单类 #

创建专门用于处理Price字段校验的表单类：

// src/Form/Type/PriceType.php
namespace App\Form\Type;

use App\Entity\Price;
use Symfony\Component\Form\AbstractType;
use Symfony\Component\Form\FormBuilderInterface;
use Symfony\Component\OptionsResolver\OptionsResolver;
use Symfony\Component\Form\Extension\Core\Type\NumberType;
use Symfony\Component\Form\Extension\Core\Type\TextType;

class PriceType extends AbstractType
{
    public function buildForm(FormBuilderInterface $builder, array $options): void
    {
        $builder
            ->add('currency', TextType::class)
            ->add('value', NumberType::class);
    }

    public function configureOptions(OptionsResolver $resolver): void
    {
        $resolver->setDefaults([
            'data_class' => Price::class,
            'csrf_protection' => false, // API场景关闭CSRF校验
        ]);
    }
}

2. 修改ProductType的prices字段配置 #

将EntityType替换为CollectionType，适配嵌套数组提交的场景：

// 顶部先导入依赖
use Symfony\Component\Form\Extension\Core\Type\CollectionType;
use Symfony\Component\Validator\Constraints\Count;

// buildForm方法内修改prices字段配置
$builder
->add('prices', CollectionType::class, [
    'entry_type' => PriceType::class,
    'allow_add' => true,
    'by_reference' => false, // 强制调用Product类的addPrice方法，而非直接修改集合属性
    'constraints' => [
        new Count([
            'min' => 1,
            'minMessage' => '至少需要设置一个价格'
        ]),
    ],
]);

3. 给Product类补全关联操作方法 #

Symfony的CollectionType默认会调用对应实体的addXXX/removeXXX方法，你需要补全这两个方法，同时在添加价格时自动绑定Product关联，避免外键为空报错：

// Product.php中新增以下两个方法
public function addPrice(Price $price): self
{
    if (!$this->prices->contains($price)) {
        $this->prices[] = $price;
        $price->setProduct($this);
    }
    return $this;
}

public function removePrice(Price $price): self
{
    if ($this->prices->removeElement($price)) {
        if ($price->getProduct() === $this) {
            $price->setProduct(null);
        }
    }
    return $this;
}

4. 确认FOSRestBundle配置 #

确保config/packages/fos_rest.yaml中开启了JSON请求解析，表单才能正常接收参数：

fos_rest:
    body_listener: true
    format_listener:
        rules:
            - { path: ^/api, prefer_extension: false, fallback_format: json, priorities: [ json ] }

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