Symfony 6.2自定义验证器错误未显示对应字段的路径问题

核心问题分析 #

你的验证器生成的错误路径是data.funderData[1].name，但表单实际渲染的字段路径是funderData[items][1].name——这是因为AbstractSimpleArrayType用items作为CollectionType的字段名承载数组元素，而验证器直接针对实体的数组字段funderData的元素校验，两者的路径结构差了一层items。

解决方案1：在自定义验证器中修正错误路径 #

直接在AssertFunderData验证器里，通过ExecutionContextInterface调整错误的属性路径，补上items层级，让错误精准关联到对应的表单字段。

代码实现 #

use Symfony\Component\Validator\Constraint;
use Symfony\Component\Validator\Context\ExecutionContextInterface;

class AssertFunderDataValidator extends ConstraintValidator
{
    public function validate($value, Constraint $constraint, ExecutionContextInterface $context)
    {
        // 校验单个funder data元素的name字段
        if (empty($value['name'])) {
            // 获取当前验证的属性路径（例如："funderData[1]"）
            $currentPath = $context->getPropertyPath();
            
            // 替换路径中的索引格式，补上items层级
            // 把 "[1]" 替换为 "[items][1]"
            $correctedPath = preg_replace('/\[(\d+)\]/', '[items][$1]', $currentPath);
            
            // 设置修正后的完整路径（加上.name）
            $context->setPropertyPath($correctedPath . '.name');
            
            // 添加验证错误
            $context->buildViolation($constraint->nameMissingMessage)
                ->addViolation();
        }

        // 其他字段的校验逻辑同理处理
    }
}

解决方案2：调整表单的error_mapping #

如果不想修改验证器逻辑，也可以在FunderDataType（或其父类AbstractSimpleArrayType）中配置error_mapping，将实体路径映射为表单路径：

use Symfony\Component\OptionsResolver\OptionsResolver;

class FunderDataType extends AbstractSimpleArrayType
{
    public function configureOptions(OptionsResolver $resolver)
    {
        parent::configureOptions($resolver);
        
        $resolver->setDefaults([
            'error_mapping' => [
                // 将实体的数组元素路径映射到表单的items字段路径
                '[].name' => 'items[].name',
                // 其他字段同理，比如 '[].email' => 'items[].email'
            ],
        ]);
    }
}

补充说明 #

1. Assert\All配置保持不变：实体上的#[Assert\All]注解无需修改，它会正常遍历funderData数组的每个元素并应用AssertFunderData验证器。
2. 错误定位效果：两种方案都能让验证错误显示在对应的name输入框下方，而非表单顶部。
3. 方案选择：方案1更贴近验证逻辑本身，适合希望验证器输出准确路径的场景；方案2偏向表单层适配，适合不想侵入验证器代码的场景。

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