Symfony表单提交时类型不匹配错误排查及数据存储方案

错误信息 #

App\Form\SignalType::App\Form{closure}(): Argument #2 ($actionPlanStatus) must be of type ?App\Entity\Signal, App\Entity\Status given, called in C:\laragon\www\abc\src\Form\SignalType.php on line 64

相关代码 #

表单类（SignalType） #

namespace App\Form;

use App\Entity\Status;
use App\Entity\Signal;
use Symfony\Component\Form\AbstractType;
use Doctrine\ORM\EntityRepository;
use Doctrine\ORM\QueryBuilder;
use Symfony\Bridge\Doctrine\Form\Type\EntityType;
use Symfony\Component\Form\FormBuilderInterface;
use Symfony\Component\OptionsResolver\OptionsResolver;
use Symfony\Component\Form\FormEvents;
use Symfony\Component\Form\FormEvent;
use Symfony\Component\Form\FormInterface;

class SignalType extends AbstractType
{
    public function buildForm(FormBuilderInterface $builder, array $options): void
    {
        $builder
            ->add('actionPlan')
            ->add('actionPlanStatus', EntityType::class, [
                'mapped' => false,
                'class' => status::class,
                'query_builder' => function (EntityRepository $er): QueryBuilder {
                    return $er->createQueryBuilder('u');
                },
                'choice_label' => 'name',
            ])
            ->add('deadline')   
        ;
        $formModifier = function(FormInterface $form, Signal $actionPlanStatus = null){   
        };
        $builder->get('actionPlanStatus')->addEventListener(
            FormEvents::POST_SUBMIT,
            function (FormEvent $event) use ($formModifier){
                $actionPlanStatus = $event->getForm()->getData();
                $formModifier($event->getForm()->getParent(), $actionPlanStatus);
            }
        );
    }
    public function configureOptions(OptionsResolver $resolver): void
    {
        $resolver->setDefaults([
            'data_class' => Signal::class,
        ]);
    }
}

控制器代码 #

public function yourAction(Request $request): Response
{
    $form = $this->createForm(SignalType::class);

    $form->handleRequest($request);

    if ($form->isSubmitted() && $form->isValid()) {
        // Handle form submission
    }

    return $this->render('_form.html.twig', [
        'form' => $form->createView(),
    ]);
}

根本原因 #

1. 类型声明不匹配：formModifier闭包的第二个参数被声明为Signal类型，但actionPlanStatus字段关联的是Status实体，提交后传入的是Status对象，触发类型错误。
2. 字段未映射到实体：actionPlanStatus设置了mapped => false，导致表单值不会自动同步到Signal实体，无法存入数据库。
3. 冗余事件监听：当前的POST_SUBMIT监听和formModifier逻辑为空，没有实际作用，反而引发错误。

修复方案 #

1. 修正类型声明或移除冗余监听 #

如果不需要动态修改表单的逻辑，直接删除整个事件监听代码块（包括formModifier和addEventListener）即可。如果需要保留监听，修正参数类型：

// 修正后的formModifier
$formModifier = function(FormInterface $form, ?Status $actionPlanStatus = null){   
    // 在这里添加实际需要的表单修改逻辑
};

2. 配置字段自动映射到实体 #

如果Signal实体中已经定义了actionPlanStatus属性（关联Status），移除mapped => false配置，让Symfony自动处理值映射：

->add('actionPlanStatus', EntityType::class, [
    // 移除'mapped' => false
    'class' => Status::class,
    'query_builder' => function (EntityRepository $er): QueryBuilder {
        return $er->createQueryBuilder('u');
    },
    'choice_label' => 'name',
])

3. 完善控制器的持久化逻辑 #

在控制器中初始化Signal实体，并将其持久化到数据库：

use Doctrine\ORM\EntityManagerInterface;

public function yourAction(Request $request, EntityManagerInterface $em): Response
{
    $signal = new Signal();
    $form = $this->createForm(SignalType::class, $signal);

    $form->handleRequest($request);

    if ($form->isSubmitted() && $form->isValid()) {
        // 若保留了mapped => false，需手动赋值
        // $signal->setActionPlanStatus($form->get('actionPlanStatus')->getData());
        
        $em->persist($signal);
        $em->flush();

        return $this->redirectToRoute('your_success_route'); // 跳转至成功页面
    }

    return $this->render('_form.html.twig', [
        'form' => $form->createView(),
    ]);
}

4. 确认实体关联配置 #

确保Signal实体正确定义与Status的关联：

// src/Entity/Signal.php
namespace App\Entity;

use App\Entity\Status;
use Doctrine\ORM\Mapping as ORM;

#[ORM\Entity]
class Signal
{
    // ... 其他属性和方法

    #[ORM\ManyToOne(targetEntity: Status::class)]
    #[ORM\JoinColumn(nullable: false)] // 根据业务需求设置是否允许为空
    private ?Status $actionPlanStatus = null;

    public function getActionPlanStatus(): ?Status
    {
        return $this->actionPlanStatus;
    }

    public function setActionPlanStatus(?Status $actionPlanStatus): self
    {
        $this->actionPlanStatus = $actionPlanStatus;

        return $this;
    }
}

验证步骤 #

1. 清除Symfony缓存：php bin/console cache:clear
2. 重新提交表单，检查是否再出现类型错误
3. 查看数据库，确认actionPlanStatus字段已正确存入值

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