PHP表单不可为null字段使用NotBlank验证报错，有无其他解决方案？

问题根因 #

Symfony表单的默认执行流程是先做数据映射、后跑约束验证，你遇到的报错原因是：

1. 提交全空格内容时，TextType默认开启的trim配置会先把内容处理为空字符串
2. 表单默认会把空字符串的提交值转换为null
3. 此时NotBlank约束还未执行，null就被传给了仅接受string类型的setEnd方法，直接触发类型报错

解决方案 #

方案1：调整表单字段配置（最简便） #

在字段配置中新增empty_data参数，强制空提交值转换为空字符串而非null，保证传入setter的永远是string类型，后续NotBlank、Length约束可以正常触发验证：

$builder
    ->add('end', TextType::class, [
        'label'       => 'blabla',
        'empty_data'  => '', // 新增这一行
        'constraints' => [
            new Length([
                'min'        => 3,
                'minMessage' => 'Min {{ limit }} chars',
            ]),
            new NotBlank([
                'message' => 'not null blabla',
            ]),
        ],
    ])

这个方案不需要修改你的实体模型代码，保持了实体属性的非空约束，符合你的需求。

方案2：使用表单DTO承接数据（更规范的领域设计方案） #

如果不想对表单配置做特殊处理，也可以引入专门的表单DTO（数据传输对象）来承接提交的原始数据，DTO的属性可以设为nullable，等表单验证通过后，再把有效值赋值给你的业务实体：

1. 先定义表单DTO

class EndFormDTO
{
    public ?string $end = null;
}

2. 表单绑定到DTO而非业务实体，验证通过后再赋值给业务实体：

// 表单提交后验证通过的逻辑
if ($form->isSubmitted() && $form->isValid()) {
    /** @var EndFormDTO $dto */
    $dto = $form->getData();
    $blablaEntity->setEnd($dto->end); // 此时$dto->end已经过验证，肯定是非空字符串，不会触发类型错误
    // 后续持久化等逻辑
}

这个方案彻底把表单的预处理逻辑和业务实体的领域规则隔离开，业务实体永远不需要为了表单适配修改类型约束，适合复杂度较高的项目。

方案3：关闭字段的trim配置 #

如果你的业务允许提交带前后空格的内容，也可以直接关闭TextType的trim配置，这样全空格的内容会保留为字符串，不会被处理为空字符串再转成null：

$builder
    ->add('end', TextType::class, [
        'label'       => 'blabla',
        'trim'        => false, // 新增这一行
        'constraints' => [
            // 你的约束不变
        ],
    ])

这个方案适用于有特殊输入格式要求的场景，注意关闭trim后需要自己处理前后空格的校验逻辑。

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