Symfony 5.4 表单验证由 Validator 组件驱动，依托实体注解、表单类非映射字段约束及控制器中 isValid() 触发三步协同完成；实体用 @Assert 注解定义基础规则，表单类通过 constraints 为 mapped=>false 字段添加验证，控制器调用 handleRequest() 和 isValid() 执行校验并自动渲染错误。
Symfony 5.4 的表单验证不是靠前端 JS 或手动 if 判断，而是由 Validator 组件驱动、与表单类型和实体类深度协同的结构化流程。核心在于三处配置：实体字段注解（或 YAML/XML）、表单类中对非映射字段的约束声明、控制器里调用 isValid() 触发校验链。
在实体类中定义基础验证规则
验证逻辑优先落在数据模型上，使用注解最直观。确保已安装 validator 组件（composer req validator），然后在实体属性上方添加约束：
- @Assert\NotBlank：字段不能为空（含仅空格）
- @Assert\Email：格式必须为合法邮箱
- @Assert\Length(min=2, max=50)：限制字符串长度
- @Assert\Positive：数字必须大于 0（适合 price 字段）
例如 Product.php 中：
/** * @ORM\Column(type="string", length=255) * @Assert\NotBlank(message="商品名称不能为空") * @Assert\Length(max=255) */ private ?string $name = null;
在表单类中补充未映射字段的验证
像密码确认、服务条款勾选这类不存入数据库的字段，需在表单类中显式加约束：
- 用 mapped => false 声明该字段不写入实体
- 通过 constraints 选项直接传入验证器实例，如
new Assert\IsTrue()或[new Assert\NotBlank(), new Assert\Length(['min' => 6])]
示例（RegistrationType.php）：
$builder->add('termsAccepted', CheckboxType::class, [
'mapped' => false,
'constraints' => new Assert\IsTrue(),
]);控制器中触发验证并处理结果
创建表单后，handleRequest() 自动绑定请求数据并准备校验；isValid() 才真正执行全部约束检查：
- 调用 $form->handleRequest($request) 后，无需手动解析 $_POST
- 用 $form->isSubmitted() && $form->isValid() 判断是否通过校验
- 失败时，错误信息会自动挂载到对应字段，Twig 中
{{ form_errors(form.name) }}可直接输出 - 成功后，
$form->getData()返回已填充的对象，可直接交给 Doctrine 持久化
验证失败时的模板渲染技巧
Twig 模板中不用手写 error 提示，利用内置函数即可：
-
{{ form_start(form) }}自动包含 CSRF 隐藏字段 -
{{ form_row(form.name) }}一次性渲染 label + widget + errors - 单独控制：用
{{ form_label(form.email) }} {{ form_widget(form.email) }} {{ form_errors(form.email) }} - 全局错误（如自定义约束抛出的顶级错误）用
{{ form_errors(form) }}
