Symfony加载Doctrine Fixtures报参数数量不匹配错误解决方法

Doctrine ORM 在第一次执行对应实体的flush()操作时，会根据当前的ClassMetadata配置生成固定的INSERT/UPDATE SQL模板，存入内存缓存供后续同类型实体操作复用。你在第一次flush保存自动ID的Tenant之后才修改ID生成器配置，不会触发已缓存的SQL模板更新，最终导致生成的SQL不带id字段占位符，但绑定参数时却把手动传入的id值也带上，触发参数数量不匹配的错误。

不要在实体持久化流程中途动态修改元数据配置，以下两种方案均可正常实现需求：

方案1：调整执行顺序，操作前统一配置元数据 #

将ID生成器的调整放到所有持久化操作之前，先处理手动指定ID的实体，再切回自增模式处理自动生成ID的实体，切换配置后清理EntityManager的运行时缓存，避免复用旧的SQL模板：

<?php

declare(strict_types=1);

namespace App\DataFixtures;

use App\Entity\Tenant;
use Doctrine\Bundle\FixturesBundle\Fixture;
use Doctrine\ORM\Id\AssignedGenerator;
use Doctrine\ORM\Id\IdentityGenerator;
use Doctrine\ORM\Mapping\ClassMetadataInfo;
use Doctrine\Persistence\ObjectManager;

final class TenantFixtures extends Fixture
{
    public function load(ObjectManager $manager): void
    {
        $metadata = $manager->getClassMetadata(Tenant::class);
        
        // 先配置为手动指定ID模式，处理固定ID的租户
        $metadata->setIdGenerator(new AssignedGenerator());
        $metadata->setIdGeneratorType(ClassMetadataInfo::GENERATOR_TYPE_NONE);

        $tenant = new Tenant();
        $tenant->setId(100);
        $tenant->setDomain('2.example.com');
        $tenant->setName('Tenant 2');
        $manager->persist($tenant);
        $manager->flush();

        // 清理运行时缓存，切回自增模式
        $manager->clear();
        $metadata->setIdGenerator(new IdentityGenerator());
        $metadata->setIdGeneratorType(ClassMetadataInfo::GENERATOR_TYPE_AUTO);

        $tenant = new Tenant();
        $tenant->setDomain('1.example.com');
        $tenant->setName('Tenant 1');
        $manager->persist($tenant);
        $manager->flush();
    }
}

方案2：实体层配置支持手动赋值ID（长期推荐） #

直接修改Tenant实体的ID生成策略，允许手动赋值ID，未手动赋值时由数据库自增生成ID，完全不需要在夹具中动态修改元数据，从根源避免配置不一致问题。以PHP8属性注解为例：

// Tenant实体ID字段配置
#[ORM\Id]
#[ORM\GeneratedValue(strategy: 'NONE')]
#[ORM\Column(type: 'integer')]
private ?int $id = null;

// 保留setId方法供手动赋值场景使用
public function setId(int $id): self
{
    $this->id = $id;
    return $this;
}

该配置下，调用setId(100)时Doctrine会直接使用传入的ID值，不调用setId时会依赖数据库表的AUTO_INCREMENT属性自动生成ID，夹具代码无需做任何动态元数据修改，逻辑更稳定。

注意：使用该方案需要确认数据库中tenant表的id字段已设置AUTO_INCREMENT属性，否则未手动传ID时会插入失败。

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