Symfony @Assert校验在Sonata Admin实体中失效问题排查

常见失效原因（按出现概率排序） #

• 校验器映射缓存未刷新
  Symfony 校验器会将所有实体的校验规则元数据缓存到独立缓存池，你针对competitionTypes字段新增的校验规则，如果没有触发缓存重新生成，校验器会始终读取旧的实体元数据，自然不会触发任何校验。这是同实体其他字段校验正常、仅新增强校验规则静默失效的最高发场景。

  排查操作：执行php bin/console cache:pool:clear validator.mapping.cache.doctrine 清空校验器专属的映射缓存，再重新提交表单测试。

• 表单触发的校验组与注解配置不匹配
  你提到参照同实体year字段的配置补充了"KNS-2020-2"校验组，但需要确认当前ExperienceInCompetitionAdmin（Sonata Admin类）实际触发的校验组列表：
  很多项目会在全局Sonata配置或是单个Admin类的configureOptions方法中自定义表单的validation_groups，如果配置的校验组列表没有包含"KNS-2020-2"，或是year字段本身同时配置了Default默认组和自定义组的校验规则、而你仅给competitionTypes配置了自定义组的规则，就会出现其他字段校验正常、该字段完全不触发校验的情况。
• 校验注解语法或引入路径错误
  两类写法错误会导致校验静默失效，不会抛出任何框架报错：
  1. 引入校验注解时命名空间写错，误引入了非Symfony校验组件的空类，而非Symfony\Component\Validator\Constraints下的真实校验类
  2. @Assert\Callback注解绑定的校验方法签名不符合要求：Symfony 4.3+版本要求Callback校验方法必须接收两个入参——第一个是违规列表对象ConstraintViolationListInterface，第二个是校验载荷mixed $payload，如果方法签名不匹配，校验器会直接跳过该方法执行。
• 表单字段与实体属性映射断开
  检查ExperienceInCompetitionAdmin类的configureFormFields方法中competitionTypes字段的配置：
  • 是否误将字段配置为'mapped' => false，导致表单提交的选择值完全没有回写到实体的competitionTypes属性上
  • 是否字段名拼写错误，导致表单字段和实体定义的competitionTypes属性完全脱钩，校验器根本不会关联到对应属性的校验规则。

可直接复用的正确配置方式 #

1. 优先使用属性级别的Count校验注解，同时覆盖默认校验组和自定义校验组：

   // 在ExperienceInCompetition实体的competitionTypes属性上配置
   #[Assert\Count(
       min: 1,
       minMessage: '比赛经历至少需要选择一个有效的比赛类型',
       groups: ['Default', 'KNS-2020-2']
   )]
   private Collection $competitionTypes;
   

2. 如果使用Callback自定义校验，确保方法签名符合规范：

   /**
    * @Assert\Callback(groups={"Default", "KNS-2020-2"})
    */
   public function validateCompetitionTypes(
       ConstraintViolationListInterface $violations,
       mixed $payload
   ): void {
       if ($this->competitionTypes->isEmpty()) {
           $violations->add(new ConstraintViolation(
               '比赛经历至少需要选择一个有效的比赛类型',
               null,
               [],
               $this,
               'competitionTypes',
               null
           ));
       }
   }
   

3. 确认表单中competitionTypes字段没有设置mapped: false，字段名与实体属性名完全一致。

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