级联验证的核心是@assert\valid，必须显式标注在关联对象或数组属性上才能触发递归校验；对对象数组用@assert\valid，对字符串数组则需@assert\all包裹子约束，并确保元数据加载、注解注册及属性映射配置正确。
级联验证的核心是 @Assert\Valid
默认情况下，Symfony Validator 不会自动进入关联对象或数组内部做校验。比如一个 User 类包含 private Address $address;，即使 Address 类本身有 @Assert\NotBlank 等规则，不加额外标注，$address 的字段根本不会被检查。
解决办法很简单：在目标属性上加上 @Assert\Valid 注解。
- 对单个对象属性：
/** @Assert\Valid */ private Address $address; - 对对象数组：
/** @Assert\Valid */ private array $posts; - 对关联集合（如 Doctrine 关系），同样适用，只要类型是对象即可
嵌套数组元素怎么校验？分情况处理
数组内容不同，配置方式也不同：
- 如果数组里全是对象（例如
Product[] $items），直接在属性上加@Assert\Valid就够了，Validator 会递归验证每个Product实例 - 如果数组里是简单类型（如
string[] $tags），不能用@Assert\Valid，得改用@Assert\All包裹子约束：/** @Assert\All({@Assert\NotBlank, @Assert\Length(max: 50)}) */ private array $tags; - 混合结构（如
array{email: string, role: string}）推荐用@Assert\Collection，它支持按字段名定义各自约束
别漏掉元数据加载和注解注册
级联验证失效，90% 是因为元数据没加载成功，不是逻辑写错：
- 独立使用 Validator（非完整 Symfony 项目）时，必须在入口处注册注解加载器：
use Doctrine\Common\Annotations\AnnotationRegistry;<br>AnnotationRegistry::registerLoader('class_exists'); - 确保实体类正确引入命名空间：
use Symfony\Component\Validator\Constraints as Assert;，而不是误用 Doctrine 或其他同名空间 - 注解必须写在属性上（
private string $name;上方的 docblock），写在 getter 方法上默认不生效，除非你主动配置了方法级元数据读取器
验证器实例要配对启用注解和属性映射
手动构建 Validator 时，光 new 出来不行，关键配置缺一不可：
- 支持 PHPDoc 注解：
$builder->addDefaultDoctrineAnnotationReader() - 支持 PHP 8.1+ 属性（如
#[Assert\Email]）：$builder->enableAttributeMapping(true) - 这两项漏掉任意一个，
@Assert\Valid都会被忽略，导致级联完全不触发
