Doctrine实体唯一字段增改问题：替代merge实现无查询创建/更新报错

问题根源 #

直接创建新的DoctrinePartnerDao实例并执行persist+flush时，无论guid是否已存在，Doctrine都会执行INSERT操作，触发唯一键约束错误。弃用merge后，需通过其他方式实现「存在更新、不存在创建」且避免预查询。

解决方案1：利用实体代理+异常捕获（无版本依赖） #

通过getReference创建实体代理对象（不触发DB查询），尝试更新字段后flush，若实体不存在则捕获异常并创建新实体：

public function save(Partner $partner): void
{
    $em = $this->entityManager;
    $guid = $partner->getGuid();

    try {
        // 获取实体代理，不执行DB查询
        $partnerDao = $em->getReference(DoctrinePartnerDao::class, $guid);
        // 映射Partner数据到代理对象
        $partnerDao->setName($partner->getName());
        // 其他字段映射逻辑...
        
        // 托管实体无需persist，直接flush触发更新
        $em->flush();
    } catch (\Doctrine\ORM\EntityNotFoundException $e) {
        // 实体不存在，创建新实例
        $newPartnerDao = new DoctrinePartnerDao();
        $newPartnerDao->setGuid($guid);
        $newPartnerDao->setName($partner->getName());
        // 其他字段映射逻辑...
        
        $em->persist($newPartnerDao);
        $em->flush();
    }
}

解决方案2：使用Doctrine ORM原生Upsert（2.10+版本） #

Doctrine ORM 2.10及以上提供了upsert方法，直接生成数据库级别的UPSERT语句（如MySQL的INSERT ... ON DUPLICATE KEY UPDATE），无需预查询：

public function save(Partner $partner): void
{
    $em = $this->entityManager;

    // 整理需插入/更新的字段数据
    $partnerData = [
        'guid' => $partner->getGuid(),
        'name' => $partner->getName(),
        // 其他业务字段...
    ];

    // 基于guid唯一键执行Upsert
    $em->upsert(DoctrinePartnerDao::class, $partnerData, ['guid']);
}

解决方案3：DBAL原生SQL实现Upsert（兼容低版本） #

若使用低版本Doctrine ORM，可直接通过DBAL执行原生SQL实现UPSERT：

public function save(Partner $partner): void
{
    $connection = $this->entityManager->getConnection();
    $params = [
        'guid' => $partner->getGuid(),
        'name' => $partner->getName(),
        // 其他参数...
    ];

    // MySQL示例语法
    $sql = <<<SQL
        INSERT INTO doctrine_partner_dao (guid, name)
        VALUES (:guid, :name)
        ON DUPLICATE KEY UPDATE
            name = VALUES(name)
            -- 其他字段更新逻辑...
    SQL;

    $connection->executeQuery($sql, $params);
}

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