本文详解如何解决 doctrine 中因重复主键导致的 sqlstate[23000] 错误，通过先查询再合并的方式实现安全的 upsert（update or insert）操作，避免手动 persist 新实体引发的主键冲突。
在 Symfony + Doctrine 项目中，当你使用自定义主键（如 API 返回的 id）且禁用自动增长（auto-increment）时，直接对每个数据项创建新实体并调用 persist() + flush()，会导致第二次执行时尝试重复插入相同主键值，从而触发 MySQL 的完整性约束异常：
SQLSTATE[23000]: Integrity constraint violation: 1062 Duplicate entry '60' for key 'PRIMARY'
这是因为 Doctrine 不会自动检测数据库中是否已存在该 ID 的记录——它只根据实体的“托管状态”（managed）、“游离状态”（detached）或“新建状态”（new）来决定执行 INSERT 还是 UPDATE。而你每次都在 new Articles()，Doctrine 将其视为全新实体，强制执行 INSERT。
✅ 正确做法是：先尝试按主键查找已有实体；若存在，则复用并更新字段；若不存在，则新建。这正是 Doctrine 官方推荐的“merge-like”模式（注意：不是直接用 merge()，因其有副作用，详见后文）。
以下是优化后的 refreshAllArticle() 方法：
public function refreshAllArticle(): void
{
$articlesActualise = $this->ApiManager->getAllArticles();
$entityManager = $this->getEntityManager();
foreach ($articlesActualise as $data) {
// ✅ 步骤1：按主键查找现有实体
$article = $this->find($data['id']);
// ✅ 步骤2：不存在则新建，存在则复用
if (!$article) {
$article = new Articles();
}
// ✅ 步骤3：统一更新所有字段（无论新建或已有）
$article->setId($data['id']);
$article->setDateCreation(new \DateTime($data['date_creation']));
$article->setDateModification($data['date_modification'] ? new \DateTime($data['date_modification']) : null);
$article->setTitre($data['titre']);
$article->setContent($data['content']);
$article->setDescription($data['description']);
// ⚠️ 注意：确保 setHeader() / setScript() 也按需调用（原 entity 含这些字段）
// ✅ 步骤4：持久化（Doctrine 自动识别：新实体→INSERT，已有→UPDATE）
$entityManager->persist($article);
}
// ✅ 批量 flush（性能更优，避免每轮循环都提交事务）
$entityManager->flush();
}? 关键改进点说明：
- $this->find($id) 是 ServiceEntityRepository 提供的安全查找方法，返回 ?Articles，不存在时为 null；
- 所有字段赋值统一处理，无需区分“新建逻辑”和“更新逻辑”，语义清晰；
- flush() 移至循环外：大幅提升性能，减少数据库往返次数；
- 日期字段需转换为 \DateTime 对象（Doctrine 要求），原代码中直接赋字符串会报错；
- 显式调用 setId() 即使是已有实体：确保主键一致（虽通常不必要，但可增强健壮性）。
⚠️ 为什么不直接用 $em->merge()？
merge() 会返回一个托管副本，原对象仍为游离态，易引发意外行为（如后续修改未同步）。对于简单主键更新场景，find() + setters + persist() 更直观、可控、无副作用。
? 进阶建议（可选）：
- 添加日志记录新增/更新数量：$isNew = $article instanceof Articles && !$article->getId();
- 使用 upsert 原生 SQL（MySQL 8.0.19+ 支持 INSERT ... ON DUPLICATE KEY UPDATE），但会绕过 Doctrine 生命周期事件；
- 对大批量同步启用 batchSize 或分块处理，防止内存溢出。
至此，你的 /refreshArticles 接口即可安全地多次调用，真正实现“有则更新、无则插入”的幂等同步逻辑。
