Symfony验证基于“约束+验证器”模型，通过注解等声明规则并由Validator服务统一执行；支持基础字段验证、跨字段/业务逻辑验证、手动触发与错误提取，以及条件验证和集合校验等高级功能。
Symfony验证核心是“约束（Constraint）+ 验证器（Validator）”模型：你声明规则（比如“邮箱必须有效”），框架自动执行校验并收集错误。不靠手写if判断，而是用注解、PHP属性或配置定义规则，由Validator服务统一处理。
基础字段验证：用内置约束最简单
在实体类属性上加注解，是最常用方式：
-
非空检查：
@Assert\NotBlank，默认不允许null和空字符串；加allowNull=true可接受null -
长度控制：
@Assert\Length(min=2, max=50)，支持minLength/maxLength别名，也支持exact精确匹配 -
格式校验：
@Assert\Email(mode="strict")比默认HTML5模式更严谨；@Assert\Url(protocols={"https"})限定协议 -
数值范围：
@Assert\Range(min=0, max=100)，也支持minMessage/maxMessage自定义提示
跨字段或业务逻辑验证：用Callback或自定义Constraint
当需要比较两个字段（如密码与确认密码）、或调用服务做数据库查重时，内置约束不够用：
-
Callback约束：在实体中写一个public方法，加上
@Assert\Callback注解，方法接收ExecutionContextInterface $context，手动调$context->buildViolation()->addViolation() -
自定义Constraint类：必须继承
Constraint，加@Assert\Target("PROPERTY")或"CLASS"；validatedBy()返回对应Validator类名；所有配置项（如public $threshold = 3;）需为public属性，通过options注入 - 验证器类里
validate($value, Constraint $constraint)中，$value只是当前字段值；要访问其他字段，得用$context->getObject()拿到整个对象再取属性
验证执行与错误提取：别漏掉关键步骤
验证不是加了注解就自动生效，得主动调用：
- 表单提交后，
$form->isValid()会触发验证；也可手动用$validator->validate($entity) - 错误信息存在
ConstraintViolationListInterface里，遍历用$violation->getPropertyPath()定位字段，$violation->getMessage()取提示 - 前端显示时，Twig里用
{{ form_errors(form.email) }}自动渲染对应字段错误；若用API，需把ViolationList转成JSON结构返回
高级技巧：条件验证与集合校验
复杂场景有现成工具，不用硬编码逻辑：
-
@Assert\When：根据表达式决定是否启用某组约束，例如
when="this.getStatus() === 'active'"，配合then或otherwise分支 -
@Assert\Collection：验证数组或DTO对象的每个子字段，例如
"name" = @Assert\NotBlank(), "email" = @Assert\Email()，还支持allowExtraFields=false禁止未知键 - 文件上传验证可用
@Assert\Image，直接限制minWidth、mimetypes、maxSize等，无需自己读文件头
