非Symfony项目中Symfony Validation的NotBlank约束未触发违规排查

Hey，我之前也踩过这个坑！你现在遇到的问题核心是：直接用Validation::createValidator()创建的是基础验证器，它默认不会读取类上的@Assert注解约束。这个基础验证器只能用来验证单个值，没法识别类属性上的注解规则。

解决步骤 #

1. 确认依赖安装完整

要让注解生效，除了symfony/validator，还需要安装注解处理相关的包。在项目根目录执行：

composer require symfony/validator symfony/annotation symfony/cache

symfony/cache用来缓存验证元数据，能提升后续验证的性能，建议一起安装。

2. 构建支持注解的验证器

不要直接用createValidator()，而是用ValidatorBuilder来创建验证器，添加注解加载器。修改你的验证代码如下：

use Symfony\Component\Validator\Validation;
use Symfony\Component\Validator\Mapping\Loader\AnnotationLoader;
use Doctrine\Common\Annotations\AnnotationReader;

// 初始化注解读取器，用来扫描类上的@Assert注解
$annotationReader = new AnnotationReader();

// 构建带注解支持的验证器
$validator = Validation::createValidatorBuilder()
    ->addLoader(new AnnotationLoader($annotationReader))
    ->getValidator();

// 再执行你的验证逻辑
$user = new User();
$user->setId('');
$errors = $validator->validate($user);
var_dump(count($errors)); // 现在应该输出1，符合预期了

3. 检查User类的注解写法

还要确保你的User类里的注解格式正确：

• 必须引入Symfony\Component\Validator\Constraints命名空间并取别名
• 注解要写在文档注释块里（PHP 7及以下），或者用PHP 8属性写法

PHP 7及以下写法：

use Symfony\Component\Validator\Constraints as Assert;

class User
{
    /**
     * @Assert\NotBlank(message="ID不能为空")
     */
    private $id;

    public function setId($id)
    {
        $this->id = $id;
        return $this;
    }

    public function getId()
    {
        return $this->id;
    }
}

PHP 8+ 属性写法（更简洁）：

use Symfony\Component\Validator\Constraints as Assert;

class User
{
    #[Assert\NotBlank(message: "ID不能为空")]
    private $id;

    // 省略setId和getId方法
}

补充说明 #

如果只是验证单个值，直接用createValidator()是没问题的，比如：

$validator = Validation::createValidator();
$errors = $validator->validate('', new Assert\NotBlank());
var_dump(count($errors)); // 输出1

但要验证类属性上的注解约束，必须通过ValidatorBuilder添加对应的加载器（注解加载器、XML加载器或者YAML加载器，这里我们用的是注解加载器）。

内容的提问来源于stack exchange，提问作者Martyn