TypeORM如何仅更新请求传入的变更字段、保留其余原有值

以下两种实现均可满足「仅更新传入参数与数据库现有值不同的字段，其余字段保持不变」的需求，兼容TypeORM 0.2.x及0.3.x主流版本。

方案1：手动查询+合并更新（通用度最高） #

实现逻辑：先查询现有记录，合并传入参数后调用save方法，TypeORM内置脏检查机制会自动识别变化字段，仅生成对应字段的更新SQL。
代码示例：

// 0.3.x 版本写法
import { NotFoundException } from '@nestjs/common'; // 其他框架可自定义异常逻辑

// 1. 按唯一条件查询现有记录
const existingRecord = await entityARepository.findOneBy({ name: 'Joe' });
if (!existingRecord) {
  throw new NotFoundException('待更新记录不存在');
}

// 可选：过滤不允许更新的字段，比如禁止修改name字段
const { name, ...allowUpdateFields } = req.body;

// 2. 合并要更新的字段到现有记录实例
Object.assign(existingRecord, allowUpdateFields);

// 3. 保存，仅会更新有变化的字段
await entityARepository.save(existingRecord);

如果使用0.2.x版本，只需将第一步的findOneBy替换为findOne({ where: { name: 'Joe' } })即可，其余逻辑完全一致。

方案2：使用preload方法（代码更简洁） #

TypeORM内置的preload方法已封装「查询现有记录+合并传入属性」的逻辑，无需手动实现合并步骤：

const updatePayload = {
  // 要匹配的唯一查询条件
  name: 'Joe',
  // 前端传入的更新字段
  ...req.body
};

// 自动查询记录并合并属性
const toUpdate = await entityARepository.preload(updatePayload);
if (!toUpdate) {
  throw new NotFoundException('待更新记录不存在');
}

await entityARepository.save(toUpdate);

注意事项 #

• 请确保用作查询条件的name字段是唯一键，避免匹配到多条记录更新错误，优先使用主键作为查询条件更稳妥
• save方法默认只会生成变化字段的UPDATE语句，不会全量覆盖所有字段，符合需求场景
• 建议搭配DTO校验工具（如class-validator）过滤前端传入的非法字段，避免更新到不允许修改的系统字段

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