constraint类未被调用最常见原因是未继承constraint父类或遗漏@assert\target注解，导致symfony静默忽略；validatedby()返回值须与validator类名严格一致；validator类不能为final且需启用autoconfigure或打tag。
自定义验证器类为什么没被调用？
最常见的情况是 Constraint 类没被 Symfony 识别，表现为表单提交后完全不触发验证逻辑，也没有任何错误提示——不是报错，而是静默失效。
必须同时满足以下三点：
-
Constraint子类要继承Constraint父类，并且顶部加@Assert\Target注解（值为Target::PROPERTY或Target::CLASS） -
validatedBy()方法返回的字符串，必须和实际ConstraintValidator类名（含命名空间）严格一致，大小写敏感 - 该
ConstraintValidator类不能声明为final，且需在服务配置中启用 autoconfigure: true 或手动打上validator.constraint_validatortag
validate() 方法里 $value 是什么？
很多人误以为 $value 是整个实体对象，结果在比对“密码”和“确认密码”时取不到另一个字段——其实 $value 只是当前被校验字段的值（比如 $value 是 passwordConfirm 字段的字符串），而整个对象得从 $context->getObject() 拿。
实操建议：
- 跨字段逻辑（如两次输入一致）：用
$context->getObject()获取实体，再调getPassword()等方法 - 添加错误必须用
$context->buildViolation($constraint->message)->atPath('passwordConfirm')->addViolation()，atPath()的参数要和表单字段名/属性名完全一致 - 别在
validate()里 throw Exception，否则中断整个验证流程；所有错误都应通过buildViolation()报告
怎么传动态参数（比如最小长度可配）？
不能在 Constraint 构造函数里定义参数，比如 public function __construct(int $min = 6) —— 这会导致序列化失败，Symfony 报错 “Constraint must be serializable”。
正确做法是把配置项声明为 public 属性，并通过 $options 注入：
/**
* @Annotation
*/
class MyLength extends Constraint
{
public string $message = '长度不符合要求';
public int $min = 6;
}
使用时写成：@MyLength(min: 8)（PHP 8+ attribute 语法）或 @MyLength({"min": 8})（注解数组语法）。
业务规则依赖数据库查重怎么办？
比如“用户名已存在”这种需要查 UserRepository 的场景，不能靠 @Assert\UniqueEntity（它只支持简单字段唯一性），得走自定义约束 + Validator 注入服务。
关键点：
- 在
ConstraintValidator的__construct()中接收UserRepository（或通过ContainerInterface延迟获取） - 验证前先检查
$value是否为空或无效，避免无意义查询 - 注意 Doctrine 实体状态：如果用户刚 new 出来还没 persist，
$repository->findOneBy(['username' => $value])查不到自己，但更新场景下得排除当前 ID
复杂点在于：这个验证器必须能区分新建 vs 编辑，且不能因 DB 查询失败而崩掉——得包一层 try/catch 并转成用户友好的 buildViolation()。
