Symfony自定义约束需由Constraint和ConstraintValidator两个类组成：前者定义规则与消息，必须继承Constraint、用@Attribute标注目标、声明public配置属性；后者实现validate()逻辑，通过buildViolation()报错而非抛异常，且不可final。
写 Symfony 自定义约束，关键不是“堆功能”，而是让约束可配置、可复用、不破坏验证流程。它由两个类组成：一个声明规则（Constraint），一个执行判断（ConstraintValidator）。漏掉任一环节，或写法不规范，约束就会静默失效——连错误提示都没有。
约束类（Constraint）：定义规则和消息
这个类告诉 Symfony “要验什么”和“错的时候说什么”。必须继承 Symfony\Component\Validator\Constraint，并带上 @Attribute 注解标明作用目标。
- 所有可配置项（如
minLength、keywords）必须声明为 public 属性，不能靠构造函数传参（否则序列化失败） - 重写
validatedBy()，返回对应验证器类的完整类名（大小写敏感，比如'App\Validator\ContainsKeywordValidator'） -
@Attribute必须指定Attribute::TARGET_PROPERTY（验证字段）或Attribute::TARGET_CLASS（验证整个对象），不能省略 - 错误消息用
{{ placeholder }}占位，运行时自动替换，比如'The value "{{ value }}" is not allowed.'
验证器类（ConstraintValidator）：实现具体逻辑
这个类真正干活，接收被校验的值和约束实例，决定是否报错。必须继承 Symfony\Component\Validator\ConstraintValidator。
-
validate($value, Constraint $constraint)中：$value是当前字段的值（不是整个对象），$constraint才是你自定义约束的实例，含所有配置和消息 - 需要访问其他字段？用
$this->context->getObject()拿到整个实体，再手动取属性，比如$object->getPassword() - 报错必须调用
$this->context->buildViolation($constraint->message)->atPath('fieldName')->addViolation()；atPath()的字符串必须和实际属性名完全一致，否则前端收不到对应字段错误 - 禁止抛异常——验证器预期你通过
buildViolation()报告问题，抛 Exception 会中断整个验证流程
注册与使用：确保 Symfony 能找到它
类写完不等于能用，还得让容器识别。
- 验证器类不能加
final关键字（Symfony 需要代理） - 服务需启用
autoconfigure: true（推荐），或手动打标签validator.constraint_validator - 在实体中使用时，直接注解即可：
#[ContainsKeyword(keywords: ['admin', 'root'])]，Symfony 自动把keywords塞进约束实例的 public 属性 - 验证整个对象（比如跨字段检查）？把约束加在类上，并在
@Attribute中设Attribute::TARGET_CLASS
常见踩坑点直击
这些错误不会报错，但约束完全不生效，最容易浪费半天时间排查：
- 忘记
@Attribute或Target写错 → Symfony 静默跳过 -
validatedBy()返回的类名拼错、大小写不对、命名空间少一级 → 找不到验证器，无提示 - 约束类里用
__construct(int $min)传参 → 序列化失败，缓存加载时报错或忽略 - 在
validate()里直接dump($value)然后发现是 null → 实际是字段没赋值，或表单没映射该字段，不是验证器问题
