如何对带约束属性的Symfony DTO进行单元测试

直接实例化DTO时，Symfony Validator不会自动执行验证逻辑。#[MapQueryString]注解是依托Symfony的ArgumentResolver机制，在解析请求参数绑定到DTO的过程中，自动调用Validator组件完成验证并抛出异常；但你手动new DTO只是初始化了属性值，完全不会触发任何验证流程。

在单元测试里直接复用DTO上的Assert约束，只需要手动调用Symfony的Validator服务完成验证，不需要重复写Webmozart Assert逻辑，步骤如下：

1. 在测试类中注入Validator服务 #

如果是基于KernelTestCase的功能测试，可以通过容器获取Validator：

use Symfony\Component\Validator\Validator\ValidatorInterface;
use Symfony\Bundle\FrameworkBundle\Test\KernelTestCase;

class AuthCallbackDtoTest extends KernelTestCase
{
    private ValidatorInterface $validator;

    protected function setUp(): void
    {
        self::bootKernel();
        $this->validator = self::getContainer()->get(ValidatorInterface::class);
    }
}

2. 编写验证逻辑的测试用例 #

创建DTO实例后，调用validate()方法获取约束违规信息，再根据结果做断言：

public function testInvalidDtoHasValidationErrors()
{
    // 创建不符合规则的DTO实例
    $dto = new AuthCallbackDto();
    $dto->code = '123'; // 长度不足5
    $dto->session_state = ''; // 空值

    // 执行验证
    $violations = $this->validator->validate($dto);

    // 断言违规数量符合预期
    $this->assertCount(2, $violations);

    // 可选：检查具体的错误提示
    $this->assertEquals('This value should not be blank.', $violations[0]->getMessage());
    $this->assertEquals('This value is too short. It should have 5 characters or more.', $violations[1]->getMessage());
}

3. 模拟控制器中的异常抛出场景（可选） #

如果你想完全模拟#[MapQueryString]触发的ValidationFailedException，可以手动抛出该异常：

use Symfony\Component\Validator\Exception\ValidationFailedException;

// ...

public function testInvalidDtoTriggersValidationException()
{
    $dto = new AuthCallbackDto();
    $dto->code = 'abc'; // 不符合长度要求

    $violations = $this->validator->validate($dto);

    if (count($violations) > 0) {
        throw new ValidationFailedException($dto, $violations);
    }

    // 如果没抛出异常，测试失败
    $this->fail('Expected ValidationFailedException was not thrown.');
}

Symfony Validator是显式触发的验证机制，只有框架层面的组件（比如ArgumentResolver、表单、Doctrine实体监听等）会自动调用验证；手动实例化对象时，必须显式调用Validator才能让Assert约束生效，这也是为什么你直接new DTO时看不到验证效果的原因。

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