Symfony表单编辑实体时空字段触发500错误，如何解决？

场景复现 #

编辑实体代码 #

public function editTraining(Training $training) {
    $form = $this->createForm(TrainingFormType::class, $training);
    $form->submit($request->request->all());
}

表单字段配置 #

->add('title', TextType::class, [
      'constraints' => [
          new NotBlank(),
          new Length(null, null, 50)
]])

异常现象 #

当请求传入"title" : ""时，触发500错误：

"Expected argument of type "string", "null" given at property path "title"."

但创建新实体时（代码如下），能正常返回预期的表单验证错误：

$training = new Training();
$form = $this->createForm(TrainingFormType::class, $training);
$form->submit($request->request->all());

返回的验证错误：

"title": {
          "errors": [
            "This value should not be blank."
          ]
},

尝试过使用IgnoreNonSubmittedFieldListener，但问题依旧。

解决方案 #

1. 调整实体setter方法适配空值 #

编辑场景下的类型错误，核心是现有实体的title字段为非空字符串类型，但表单会将空提交转换为null，赋值时违反类型约束。

修改实体的setTitle方法，允许接收null并做兼容处理：

// 示例1：将null转为空字符串（适配数据库字段非空的情况）
public function setTitle(?string $title): self
{
    $this->title = $title ?? '';
    return $this;
}

// 示例2：直接允许null（需确保数据库字段允许null）
public function setTitle(?string $title): self
{
    $this->title = $title;
    return $this;
}

2. 配置表单字段的empty_data选项 #

在表单字段配置中添加empty_data，指定空提交时传入空字符串而非null，让NotBlank约束正常触发：

->add('title', TextType::class, [
      'constraints' => [
          new NotBlank(),
          new Length(null, null, 50)
      ],
      'empty_data' => '' // 空提交时使用空字符串替代null
])

3. 使用handleRequest替代直接提交请求参数 #

编辑场景下，推荐用Symfony表单的handleRequest方法处理提交，它会遵循表单设计逻辑，更智能地处理空值转换：

public function editTraining(Training $training, Request $request) {
    $form = $this->createForm(TrainingFormType::class, $training);
    $form->handleRequest($request); // 替代submit($request->request->all())
    
    if ($form->isSubmitted() && $form->isValid()) {
        // 后续保存逻辑
    }
}

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