Symfony项目中Validations Groups验证组对表单不生效问题咨询

问题原因 #

你遇到的报错不属于验证组的校验逻辑触发，是表单数据映射阶段的类型错误，执行时机早于Symfony验证器的分组校验流程：

1. EntityType默认required属性为true，你提交的user id 748没有匹配到对应的User实体时，字段解析结果为null
2. 你的Phones实体的user属性声明为不可为null的User类型，表单往实体映射数据时直接抛出类型错误，还没走到后续的验证组判断环节
3. 另外你在表单字段上配置validation_groups的用法错误：该参数用于控制字段关联对象的级联验证组，不能用来控制当前字段是否跳过验证，分组验证规则需要定义在实体属性的断言上。

解决方案 #

方案1：动态增减表单字段（推荐） #

更新场景不需要提交user字段的话，直接在构建表单时根据传入的验证组判断是否添加该字段即可：

class FormType extends AbstractType
{
    public function buildForm(FormBuilderInterface $builder, array $options)
    {
        // 仅创建场景添加user字段
        if (in_array('create', $options['validation_groups'], true)) {
            $builder->add('user', EntityType::class, [
                'class' => User::class,
                'invalid_message' => '用户不存在'
            ]);
        }
        
        $builder
            ->add('number', EntityType::class, [
                'class' => Numbers::class
            ])
            ->add('phone', TextType::class);
    }

    public function configureOptions(OptionsResolver $resolver)
    {
        $resolver->setDefaults([
            'data_class' => Phones::class,
            'allow_extra_fields' => true,
            'validation_groups' => ['create', 'update'],
            // Symfony新版本已弃用cascade_validation，换成在实体关联属性上加#[Assert\Valid]注解
            // 'cascade_validation' => true,
        ]);
    }
}

方案2：实体断言绑定验证组 #

如果更新场景允许提交user字段，只需要跳过非空校验，就在实体的user属性的断言上指定验证组：

// App\Entity\Phones 实体类
#[ORM\Entity]
class Phones
{
    // 给断言指定仅create组生效
    #[Assert\NotBlank(message: '用户不能为空', groups: ['create'])]
    #[ORM\ManyToOne(targetEntity: User::class)]
    private ?User $user = null; // 注意声明为可空类型，避免映射时报类型错误

    // 其他属性...
}

原来的Service层代码不需要修改，实例化表单时传入['validation_groups' => ['update']]即可自动跳过user字段的非空校验。

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