优先写在实体类属性上，因其可复用到api、命令行等所有场景；表单类型中仅添加专属校验逻辑，避免数据不一致。
验证规则写在实体类的属性上还是表单类型里？
优先写在实体类（Entity）的属性上。Symfony 的验证系统默认基于模型层，@Assert\NotBlank、@Assert\Email 这类注解放在实体字段上，能复用到 API 请求、命令行输入、后台管理等所有使用该实体的场景，而不是只绑定某个表单。
表单类型（FormType）里也可以加验证，但仅限于「仅在此表单中生效」的逻辑，比如：$builder->add('confirmPassword', PasswordType::class, ['constraints' => [new NotBlank(), new IdenticalTo(['propertyPath' => 'password'])]])。这种属于表单专属校验，不污染实体。
常见错误是把所有规则都塞进 FormType，结果 API 接口绕过表单直接反序列化时完全不校验，导致数据不一致。
怎么让验证错误显示在指定字段而不是顶部？
默认情况下，@Assert\Valid 或嵌套对象验证的错误会挂在父级字段上，而你希望它出现在子字段（比如 user.profile.age）对应的位置。关键点有两个：
- 确保嵌套属性用了
@Assert\Valid注解（否则子对象根本不会触发验证） - 在表单构建时，对嵌套字段显式调用
add()，且不要设'mapped' => false—— 否则 Symfony 找不到字段映射关系，错误就只能堆到表单根节点 - 如果用的是表单继承（
getParent()），确认父类没覆盖或屏蔽子字段的错误渲染逻辑
例如：实体 User 有 profile 属性（关联 Profile 实体），必须在 User::$profile 上加 @Assert\Valid，且在 UserType 中写 $builder->add('profile', ProfileType::class)，不能写成 $builder->add('profile', null, ['mapped' => false])。
constraints 数组里混用注解和对象实例要注意什么？
可以混用，但要注意语法一致性。比如：
// ✅ 正确：全部用 new 实例 'constraints' => [new NotBlank(), new Length(['min' => 2])] // ✅ 正确：全部用注解数组语法（PHP 8+ attributes） 'constraints' => [new NotBlank(), new Length(min: 2)] // ❌ 错误：混用旧注解类名字符串和新实例（会报错 Class not found） 'constraints' => ['NotBlank', new Length(['min' => 2])]
另一个坑是 GroupSequence 和分组验证。如果你在 constraints 里指定了 'groups' => ['Registration']，但没在表单构建时传入对应分组（$form = $this->createForm(UserType::class, $user, ['validation_groups' => ['Registration']])），那这条规则压根不会执行。
验证失败后怎么拿到具体字段和错误信息？
别依赖 $form->getErrors() 拿全局错误——它只返回表单根级别的错误。要精确到字段，得遍历每个字段：
$errors = [];
foreach ($form->getErrors(true) as $error) {
$field = $error->getCause()?->getPropertyPath() ?? '(root)';
$errors[$field][] = $error->getMessage();
}
// $errors['email'] 就是 email 字段的所有错误
注意：$form->getErrors(true) 的 true 表示递归获取所有子字段错误；$error->getCause() 在 Symfony 6.2+ 才稳定返回 ConstraintViolation，老版本需用 $error->getOrigin() 并手动解析。另外，自定义错误消息模板里，{{ form_errors(form.email) }} 能自动匹配字段，前提是字段名和实体属性名一致，且没在表单中用 'property_path' 改过映射路径。
真正容易被忽略的是验证上下文（ExecutionContextInterface）里的 addViolation() —— 它默认挂到当前字段，但如果在回调函数里忘了设 $context->buildViolation(...)->atPath('fieldName')->addViolation()，错误就会跑到表单顶层，调试时很难定位。
