Symfony CollectionType表单类型不匹配：传入数组却期望Ville实体

错误原因 #

你的VillesCollectionType将data_class设置为Ville::class，这意味着该表单期望接收单个Ville实体，但你传入的是findAll()返回的Ville数组，类型不匹配导致报错。

解决方案 #

1. 修正VillesCollectionType配置 #

修改configureOptions方法，将data_class设为null（因为该表单用于处理数组集合，无需绑定到单个实体类）：

use App\Entity\Ville;
use Symfony\Component\Form\AbstractType;
use Symfony\Component\Form\Extension\Core\Type\CollectionType;
use Symfony\Component\Form\FormBuilderInterface;
use Symfony\Component\OptionsResolver\OptionsResolver;

class VillesCollectionType extends AbstractType
{
    public function buildForm(FormBuilderInterface $builder, array $options): void
    {
        $builder
            ->add('villes', CollectionType::class, [
                'entry_type' => VilleType::class,
                'entry_options' => ['label' => false],
                'allow_add' => true,
                'allow_delete' => true, // 可选：支持删除城市
                'by_reference' => false, // 必须：确保实体关联正确更新
                'prototype' => true, // 可选：支持前端动态添加新城市
            ]);
    }

    public function configureOptions(OptionsResolver $resolver): void
    {
        $resolver->setDefaults([
            'data_class' => null, // 改为null，允许表单接收数组结构
        ]);
    }
}

2. 调整控制器中表单数据传入方式 #

VillesCollectionType的表单结构包含一个villes字段，因此需要将城市数组包装为关联数组传入：

public function manageVilles(VilleRepository $villeRepository, Request $request): Response
{
    // 从数据库获取所有城市
    $villes = $villeRepository->findAll();
    
    // 创建表单时传入包含villes键的数组
    $form = $this->createForm(VillesCollectionType::class, ['villes' => $villes]);

    $form->handleRequest($request);

    if ($form->isSubmitted() && $form->isValid()) {
        $formData = $form->getData();
        
        // 处理表单数据：保存修改/新增的城市
        $entityManager = $this->getDoctrine()->getManager();
        foreach ($formData['villes'] as $ville) {
            $entityManager->persist($ville); // 新增城市需要persist，已有修改自动跟踪
        }
        $entityManager->flush();

        return $this->redirectToRoute('manage_villes');
    }

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

3. 前端模板示例（可选） #

如果需要支持动态添加/删除，Twig模板中可以使用CollectionType的prototype功能：

{{ form_start(form) }}
    {{ form_widget(form.villes) }}

    {# 动态添加按钮 #}
    <button type="button" id="add-ville">添加新城市</button>
{{ form_end(form) }}

<script>
    const addButton = document.getElementById('add-ville');
    const villeCollection = document.querySelector('div[data-prototype]');
    const prototype = villeCollection.dataset.prototype;
    let index = villeCollection.children.length;

    addButton.addEventListener('click', () => {
        const newVilleForm = prototype.replace(/__name__/g, index);
        villeCollection.insertAdjacentHTML('beforeend', newVilleForm);
        index++;
    });
</script>

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