Symfony验证器@Assert注解生效需三步：安装validator包、启用enable_annotations配置、正确导入Assert命名空间；独立项目须调用AnnotationRegistry::registerLoader('class_exists')，框架中需在validator.yaml内配置framework.validation.enable_annotations: true，且实体必须使用Symfony\Component\Validator\Constraints as Assert。
Symfony验证器用注解验证实体，核心就三步：装包、启注解、加@Assert——但90%的失败不是不会写，而是AnnotationRegistry::registerLoader()没调，或enable_annotations: true配错位置。
怎么让@Assert注解真正生效
注解不会自动解析，必须显式注册类加载器。不注册=白写，validate()完全无视你的@Assert\NotBlank。
- 在独立使用（非完整Symfony项目）时，入口文件（如
index.php或测试脚本开头）必须加：use Doctrine\Common\Annotations\AnnotationRegistry; AnnotationRegistry::registerLoader('class_exists'); - 若用Symfony框架，确认
config/packages/validator.yaml里有：framework: validation: { enable_annotations: true }注意：不是validation.yaml顶层配置，也不是doctrine.yaml里设 - 确保实体类用了
use Symfony\Component\Validator\Constraints as Assert;，别错用成Doctrine\ORM\Mapping下的Assert（不存在）
validate()返回空数组？检查这三件事
调了$validator->validate($user)却没报错，常见于约束“没被触发”或“对象状态不对”。
-
$user属性必须是public或有getter方法（验证器默认走property访问，非setter）；若用private+setter，需配合@Assert\Callback或改用getter访问策略 - 字段值为
null时，@Assert\Length等多数约束默认跳过（除非显式加nullable=false），而@Assert\NotBlank会拦截null/""——别混用逻辑 - 验证前确保属性已赋值。例如：
$user->setUsername('')后验证才可能触发NotBlank；如果字段还是未初始化的null，部分约束不报错
自定义错误消息为什么不显示
写了@Assert\NotBlank(message="用户名不能为空")却还是看到英文默认提示，基本是配置或语法问题。
- 消息字符串里不能换行或含未转义双引号；推荐全用单引号包裹整个注解：
/** @Assert\NotBlank(message='用户名不能为空') */
- 若用
{{ limit }}占位符（如@Assert\Length(min=3, minMessage="至少{{ limit }}位")），确保键名拼写准确——minMessage不是min_message，且只对支持该选项的约束有效 - 验证器语言包未加载？检查
translator是否启用，但纯API场景建议直接写死中文message，避免依赖翻译域
最易忽略的一点：验证器本身不处理数据库唯一性——@Assert\Unique不是内置约束，得自己写UniqueEntity（DoctrineBundle提供）或手写@Assert\Callback查库。以为加个@Assert\Email就能防重名，结果上线就被绕过。
