为何TypeScript对象补丁函数在空补丁对象时失效？

核心原因 #

你的applyPatch函数大概率存在逻辑实现缺陷，同时Cloudflare Wrangler Pages本地环境的编译/运行规则（比如TS转译配置、代码压缩）可能放大了这个问题，导致空补丁对象意外过滤了原对象的属性。

常见的错误实现场景包括：

• 错误地仅遍历补丁对象的键来构建结果，空补丁时循环不执行，最终返回不完整的对象
• 函数中加入了不必要的属性存在性判断，错误地丢弃了原对象中补丁未覆盖的属性
• 颠倒了原对象与补丁的合并逻辑，导致原属性被意外覆盖

正确的实现方式 #

要保证空补丁时完整保留原对象属性，正确的合并逻辑应该是优先使用补丁属性，无补丁时保留原对象属性，以下是两种可靠的实现：

展开运算符方式 #

function applyPatch<T>(original: T, patch: Partial<T>): T {
  return { ...original, ...patch };
}

Object.assign方式 #

function applyPatch<T>(original: T, patch: Partial<T>): T {
  return Object.assign({}, original, patch);
}

这两种实现下，传入空补丁{}时，会完整复制原对象的所有属性，不会出现属性丢失的情况。

排查步骤 #

1. 检查函数实现：对比你的applyPatch代码与上述正确实现，确认是否存在错误的遍历、赋值或判断逻辑。
2. 添加运行时日志：在Wrangler本地环境中，给函数添加console.log，打印原对象、补丁对象、函数返回结果，确认每一步的具体值，定位属性丢失的环节。
3. 核对TS编译配置：对比Wrangler环境的tsconfig.json与TS Playground的配置（比如target、strict、downlevelIteration等），不同的转译规则可能导致代码行为差异。
4. 排查外部干扰：确认是否有其他代码（比如请求中间件、序列化工具）修改了applyPatch的输入或输出对象。

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