Doctrine更新现有实体时如何处理未变更字段？

好问题！尤其是当实体包含大量字段时，这个细节对性能的影响确实值得关注。

针对你的具体场景 #

当你执行这段代码后：

$myEntity->setFirstName("Bob");
$em->persist($myEntity);
$em->flush();

Doctrine 只会生成仅更新firstName字段的 SQL 语句，也就是：

UPDATE `table` SET `firstName` = 'Bob' WHERE `ID`= "x"

不会把未修改的lastName字段也塞进 UPDATE 语句里。

核心逻辑：Doctrine 如何判断字段是否变更？ #

Doctrine ORM 靠快照对比来跟踪实体字段的变化，具体规则是：

• 当实体从数据库加载时，Doctrine 会自动生成一份所有字段的原始值快照（可以理解为加载时刻的字段值备份）。
• 当你通过 setter 方法修改字段值后，Doctrine 会把当前字段值和快照里的原始值做对比：
  • 如果两个值严格相等（PHP 的===比较逻辑，标量类型如字符串、数字的话，和==结果一致），就判定该字段「未变更」；
  • 如果值存在差异，就标记该字段为「需要更新」。
• 那些你没碰过的字段（既没调用 setter，也没手动修改属性），因为当前值和快照值完全一致，所以不会被包含在最终的 UPDATE 语句中。

补充细节 #

• 对于复杂类型（比如关联实体对象、数组字段）：
  • 关联对象会对比引用是否相同；
  • 数组字段会深度对比内容是否一致。
• 如果你手动修改了实体的私有属性（不推荐这么做，破坏封装）而没调用 setter，Doctrine 可能检测不到变化，这时候可以手动触发变更检测：

  $em->getUnitOfWork()->recomputeSingleEntityChangeSet(
      $em->getClassMetadata(MyEntity::class), 
      $myEntity
  );
  

对你场景的意义 #

你的实体有35个字段还包含TEXT类型，Doctrine 默认只更新变更字段的行为刚好能帮你优化性能——避免了不必要的大字段写入，减少数据库IO开销，完全不用担心会把所有字段都更新一遍。

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