Symfony自定义约束必须显式继承Constraint类、正确添加@Assert\Target注解且validatedBy()返回完整类名，否则静默失效；validate()中$value为当前字段值，跨字段需通过$context->getObject()获取对象，报错须用buildViolation()。
Constraint 类不继承 Constraint 或漏写 @Assert\Target 会静默失效
Symfony 不会报错，也不会调用你的验证逻辑——它直接跳过这个约束。表单提交、$validator->validate() 都不会触发它，连日志都没有。
必须同时满足三项：
-
Constraint子类要 显式继承Symfony\Component\Validator\Constraint - 类上加
@Assert\Target注解，且值只能是Target::PROPERTY或Target::CLASS（不能为空、不能拼错） - 如果验证的是字段（比如
passwordConfirm），选Target::PROPERTY；如果是整个对象（比如跨字段比对），才用Target::CLASS
常见错误：把 @Assert\Target("PROPERTY") 写成 @Assert\Target("property")（大小写敏感），或漏掉注解——结果就是“写了等于没写”。
validatedBy() 返回的验证器类名必须严格匹配命名空间和大小写
这个方法返回的字符串，是 Symfony 查找对应 ConstraintValidator 的唯一依据。拼错一个字母、多一个空格、大小写不对，都会导致“找不到验证器”，并抛出 ConstraintDefinitionException。
实操要点：
- 返回值必须是完整类名，例如
'App\Validator\CheckArrayValidator'，不是CheckArrayValidator或checkarrayvalidator - 确保该类存在、可自动加载，并且没有声明为
final（Symfony 验证器类禁止final） - 服务注册时，要么设
autoconfigure: true，要么手动打validator.constraint_validatortag
调试技巧：在验证器类里加 die('hit');，看是否执行——没 hit 就先查 validatedBy() 返回值和类路径。
validate() 中 $value 和 $constraint 容易搞反
新手常以为 $value 是整个对象，其实它只是当前被校验的那个字段值（比如 $value 是 'abc'，而你正在验证 username 字段）；真正存配置项（如 $constraint->message、$constraint->options）的是 $constraint 实例。
跨字段逻辑怎么办？比如验证 passwordConfirm 是否等于 password：
- 从
$context->getObject()拿到原始对象（如User实例） - 再用 getter 或属性访问取其他字段：
$object->getPassword()或$object->password（取决于访问策略） - 报错必须用
$context->buildViolation($constraint->message)->atPath('passwordConfirm')->addViolation()，atPath()的参数要和实际属性名完全一致 - 绝对不要在
validate()里throw new \Exception()——这会中断整个验证流程，前端收不到任何错误
数组元素间交叉验证必须用自定义约束，Assert\Collection 不行
Assert\Collection 只能对每个数组项单独校验（比如每个元素都 @Assert\Range(min=0, max=1000)），但无法表达 $data[1] > $data[0] 或 $data[1] - $data[0] 这类关系。
正确做法是创建 Target::PROPERTY 约束，接收整个数组作为 $value，然后在 validate() 里手动遍历、比较：
- 检查
\is_array($value)和长度（避免Undefined offset） - 逐个校验类型：
!is_int($value[0])→ 报$constraint->type - 范围检查：
$value[0] 1000→ 报$constraint->range - 交叉逻辑：
isset($value[1]) && ($value[1] 100)→ 报$constraint->exceeded
注意：所有配置项（如 type、range）必须声明为 public 属性，通过 $options 注入，别写构造函数——否则序列化失败。
最易被忽略的一点：约束类必须可序列化，所以所有属性只能是标量、null 或可序列化的对象；任何闭包、资源、Doctrine EntityManager 都不能塞进约束实例里——它们会在缓存验证规则时直接崩溃。
