表单验证错误不显示的主因是模板未调用form_errors()；NotBlank检查空白字符串而NotNull仅判null；自定义消息需匹配约束类message键名；AJAX提交须返回JSON并扁平化错误路径。
表单提交后验证失败，错误信息没显示出来
最常见的情况是模板里没正确渲染 form_errors() 或字段级错误。Symfony 表单默认把验证错误挂在整个表单或具体字段上，但不会自动输出——你得手动调用渲染函数。
确保在 Twig 模板中这样写：
{{ form_errors(form) }}
{{ form_row(form.name) }}
{{ form_row(form.email) }}
如果只渲染字段（如 form_widget()），错误信息会被跳过。另外注意：若用了 form_start() + 手动字段输出，必须显式加 form_errors(form.field) 或 form_errors(form) 才能看到对应层级的错误。
NotBlank 和 NotNull 验证器的区别与误用
这两个约束语义不同，选错会导致验证逻辑不符合预期：
-
NotBlank检查字符串是否为空白（null、空字符串、仅空白字符都算失败） -
NotNull只检查是否为null，空字符串、0、false都通过
比如邮箱字段用 NotNull，用户提交空字符串也能过；而密码确认字段若用 NotBlank，输入空格会报错，但用户可能真想输空格——这时应配合 TrimListener 或自定义约束。
自定义验证消息不生效
常见原因是消息 ID 写错或没传进约束实例。Symfony 验证器的消息键不是随意写的，必须匹配约束类定义的默认 message 键，或显式覆盖：
- 错误写法：
new NotBlank(['message' => '不能为空'])——message键名对，但部分约束（如Length）用的是minMessage/maxMessage - 正确写法：
new NotBlank(['message' => '该字段不能为空'])，或用 YAML/PHP 属性映射时写NotBlank: '请输入内容'
还有一种情况：你在实体类里用注解写了消息，但表单类型里又用 add() 动态加了字段，没带约束配置——那注解根本不会生效，得在表单类型中显式加约束。
AJAX 提交表单时后端返回的错误结构难解析
Symfony 默认返回 HTML 响应，AJAX 场景需要 JSON。别直接在控制器里 return $this->render()，改用 JsonResponse 并手动提取错误：
$errors = $this->getErrorsAsString($form); return new JsonResponse(['errors' => $errors], 422);
其中 $this->getErrorsAsString() 是个辅助方法，需遍历 $form->getErrors(true)，否则嵌套字段（如 user[address][city]）的错误会丢失路径信息。更稳妥的做法是用 $form->getErrors(true) 返回 FormErrorIterator，再递归构建扁平化数组，键名为字段完整路径（user.email），值为错误消息数组。
前端拿到后，要按字段名精确匹配 DOM 元素并插入提示，而不是靠顺序或模糊匹配——表单结构稍一变，错误就贴错位置。
