如何在Doctrine中使用非主键实现INSERT或UPDATE操作

你遇到的核心问题是：merge() 方法是基于实体的主键来判断是否执行更新或插入的，而你需要的是基于非主键的 client_id（对应你的 idCliente 字段）作为唯一标识来实现UPSERT。直接用 merge() 会导致当 client_id 已存在但主键不同时，插入重复记录，违反唯一约束。

下面提供两种可靠的解决方案：

方案一：手动检查记录存在性（ORM层面实现） #

这是最直观且符合Doctrine最佳实践的方式，先通过唯一字段查询现有记录，再决定是更新还是新建：

$em = getEntityManager();
$repo = $em->getRepository(ProgramaFidelidadeClientes::class);

// 按client_id查询现有实体
$programaFidelidade = $repo->findOneBy(['idCliente' => $param['idCliente']]);

if (!$programaFidelidade) {
    // 不存在则创建新实体
    $programaFidelidade = new ProgramaFidelidadeClientes();
    $programaFidelidade->setIdCliente($param['idCliente']);
}

// 统一更新字段（无论新建还是已存在）
$programaFidelidade->setIdProgramaFidelidade($param['programa']);

$em->persist($programaFidelidade);
$em->flush();

关键说明： #

• 这种方式完全基于Doctrine ORM的生命周期管理，能保证实体的状态正确同步到数据库。
• 建议在你的实体类上给 idCliente 字段添加唯一约束注解，从ORM层面避免重复数据：

  /**
   * @ORM\Entity
   * @ORM\Table(
   *     uniqueConstraints={
   *         @ORM\UniqueConstraint(name="uq_programa_cliente", columns={"id_cliente"})
   *     }
   * )
   */
  class ProgramaFidelidadeClientes
  {
      // ...主键Id字段定义
  
      /**
       * @ORM\Column(name="id_cliente", type="integer")
       */
      private $idCliente;
  
      // ...其他字段和getter/setter
  }
  

方案二：数据库层面UPSERT（性能更优） #

如果你的数据库支持原生UPSERT语法（比如MySQL的ON DUPLICATE KEY UPDATE、PostgreSQL的ON CONFLICT），可以直接用Doctrine DBAL执行原生SQL，这种方式减少了一次查询，性能更好，尤其适合批量操作：

MySQL示例： #

$connection = $em->getConnection();

$sql = <<<SQL
INSERT INTO programa_fidelidade_clientes (id_cliente, id_programa_fidelidade)
VALUES (:idCliente, :programa)
ON DUPLICATE KEY UPDATE id_programa_fidelidade = :programa
SQL;

$stmt = $connection->prepare($sql);
$stmt->execute([
    'idCliente' => $param['idCliente'],
    'programa' => $param['programa']
]);

关键说明： #

• 必须确保数据库中 id_cliente 字段已经创建了唯一索引，否则ON DUPLICATE KEY不会触发更新逻辑。
• 这种方式绕过了Doctrine的实体生命周期管理，如果之后需要使用该实体，建议重新从EntityManager中查询一次，保证实体状态最新。

内容的提问来源于stack exchange，提问作者Otavio de Souza Rocha