Constraint类必须继承Constraint父类并配@Assert\Target注解，否则Symfony静默忽略；validatedBy()须返回对应Validator类名；Target必须指定PROPERTY或CLASS；validate()中$value是字段值、$constraint是约束实例；错误需用buildViolation()添加；配置项须为public属性并通过$options注入；服务需autoconfigure: true或手动打tag；验证器类不能为final。
Constraint类必须实现Constraint父类并配@Assert\Target
不继承Constraint或漏写@Assert\Target注解，会导致Symfony完全忽略这个约束——表单提交或$validator->validate()时它压根不会被调用，连报错都没有，只有静默失效。
实操建议：
-
Constraint子类里必须重写validatedBy()，返回对应ConstraintValidator类名（如'App\Validator\MyCustomValidator'） -
@Assert\Target必须明确指定Target::PROPERTY或Target::CLASS，不能留空；验证属性就选PROPERTY，验证整个对象（比如跨字段逻辑）才用CLASS - 类名和命名空间要和
validatedBy()返回值严格一致，大小写敏感，拼错一个字母就找不到验证器
ConstraintValidator里validate()参数类型容易搞反
常见错误是把$value当成整个对象，其实它只是被校验的那个字段值；而$constraint才是你自定义的约束实例，里面才有$constraint->payload、$constraint->message等配置项。
实操建议：
- 如果需要访问其他字段（比如“确认密码”比对“密码”），得从
$context->getObject()拿整个对象，再手动取值，$value只管当前字段 - 添加错误必须用
$context->buildViolation($constraint->message)->atPath('passwordConfirm')->addViolation()，atPath()里的字符串要和实际属性名一致，否则前端收不到对应字段的错误 - 别在
validate()里抛异常，Symfony期望你通过buildViolation()报告问题；抛Exception会中断整个验证流程
验证规则里传参要用options数组，不是构造函数
很多人想给约束加动态参数（比如最小长度可配），直接在Constraint类里写__construct(int $min = 6)，结果运行时报Constraint must be serializable——因为Symfony要序列化约束对象存到缓存里，构造函数参数不支持自动序列化。
实操建议：
- 所有可配置项必须声明为
public $minLength = 6;这样的公共属性，并在__construct(array $options = [])里调用parent::__construct($options)委托父类处理 - 使用时写成
@Assert\MyCustom(minLength=8)，Symfony会自动把minLength塞进$options再反射赋值 - 如果参数是复杂结构（比如数组），确保它能被
serialize()安全处理；含闭包、资源、Doctrine实体的对象一律不行
服务注册漏掉autoconfigure: true或tags会找不到验证器
即使Constraint和Validator类都写对了，如果没正确注册为服务，Symfony在构建验证器时会 fallback 到默认逻辑，最终报The validator "App\Validator\MyCustomValidator" does not exist。
实操建议：
- 推荐用自动注册：在
config/services.yaml里确保有App\Validator\: resource: '../src/Validator/*'+autoconfigure: true - 如果手动注册，必须加
tags: [{ name: 'validator.constraint_validator', alias: 'my_custom' }]，且alias要和Constraint::validatedBy()返回值匹配（去掉命名空间后的小写形式） - 验证器类不能是
final，Symfony内部会生成代理类，final会直接报错
最常被忽略的是autoconfigure: true——它不只是省事，而是让Symfony自动识别ConstraintValidator接口并打上对应tag；没它，哪怕路径对、类名对，服务容器也认不出来。
