自定义验证约束必须同时实现Constraint和ConstraintValidator接口，Constraint类需加@Annotation和@Target注解、定义$message属性，Validator类须注册为带validator.constraint_validator标签的服务，并在validate()中通过$context->buildViolation()->atPath()->addViolation()报告错误。
验证约束类必须实现 Constraint 和 ConstraintValidator 接口
自定义验证约束不是简单写个函数就行，Symfony 要求你同时提供两个类：一个描述规则（Constraint 子类），一个执行校验逻辑（ConstraintValidator 子类）。缺一不可，否则 validate() 不会被调用或报 ConstraintDefinitionException。
常见错误是只写了 validator 类，忘了声明 constraint 类，或者没在 validator 类里正确声明 supports() 方法返回 true 对应的 constraint 实例类型。
- Constraint 类需加
@Annotation注解（如果要用注解方式启用） - Constraint 类里必须定义
$message属性（或默认值），否则运行时报Missing option "message" - Validator 类的
validate()方法第二个参数是Constraint实例，别误当成原始值
注解方式启用时，Constraint 类要加 use Annotation 和 @Target
想在实体属性上写 @MyCustomConstraint，就必须让这个类能被 Doctrine Annotations 解析。光有 @Annotation 不够，还得明确支持目标——比如只允许用在属性上，就得加 @Target("PROPERTY")。
否则即使类存在、服务注册了，PHP 解析器也会跳过该注解，验证完全不触发，且无任何提示。
- 必须
use Doctrine\Common\Annotations\Annotation; - 必须加上
@Target("PROPERTY")或@Target({"PROPERTY", "METHOD"}) - 类名和注解名要一致（如
MyCustomConstraint→@MyCustomConstraint），大小写敏感 - 如果用了
@Required或其他自定义属性，得在类中声明为 public 属性并加@var类型注解
validator 服务必须显式注册并打上 validator.constraint_validator 标签
Symfony 不会自动发现你的 validator 类。即使类名符合规范、放在默认目录下，也必须手动注册为服务，并打上 validator.constraint_validator 标签，否则容器根本不会把它当作验证器加载。
典型表现是：约束注解写了，数据也违规，但 validator->validate($obj) 返回空的 ConstraintViolationList，毫无反应。
- 在
config/services.yaml中添加：App\Validator\MyCustomConstraintValidator: tags: [{ name: 'validator.constraint_validator' }] - 标签里的
name必须是字符串'validator.constraint_validator'，不能漏引号或拼错 - 如果你用 PHP config（如
services.php），确保调用了$definition->addTag('validator.constraint_validator')
validate() 方法里别直接 throw 异常，要用 $context->buildViolation()
很多人习惯在验证逻辑里遇到问题就 throw new \InvalidArgumentException()，这是错的。ConstraintValidator 的契约是通过 $context 报告违规，而不是中断流程。抛异常会导致整个验证中止，后续约束不执行，且违反 Symfony 验证器的设计模型。
更隐蔽的问题是：某些测试环境或调试模式下异常被吞掉，看起来像“没生效”，实际是崩在半路。
- 必须调用
$context->buildViolation($constraint->message)->atPath('property')->addViolation() -
atPath()参数要匹配你要标红的字段名（如'email'），否则错误信息挂错地方 - 如果要动态插值（比如显示当前值），用
setParameter('{{ value }}', $value) - 不要忘记最后调用
addViolation()，只 build 不 add = 无声失效
最常被忽略的是 atPath() 的路径写法和 addViolation() 的调用时机——少一个括号，整条错误就消失不见，而且没有任何日志提醒。
