使用RxDB incrementalPatch更新含对象字段文档触发DOC6错误求助

问题场景 #

使用RxDB的incrementalPatch方法更新文档时，当location字段不为undefined，会触发如下DOC6错误：

RxError (DOC6):
RxDocument.populate() cannot populate because path has no ref
Given parameters: {
path:"location.latitude"
schemaObj:{
"type": "number"
}}

location字段在schema中的定义为普通嵌套对象，并非引用类型：

location: {
      type: 'object',
      properties: {
        altitude: {
          type: 'number',
        },
        latitude: {
          type: 'number',
        },
        longitude: {
          type: 'number',
        },
      },
    },

问题原因 #

RxDB的incrementalPatch内部逻辑在处理嵌套对象属性时，误将其识别为需要执行populate操作的引用字段，而location.latitude本身只是普通数字字段，没有配置ref，因此抛出错误。

解决方案 #

方案1：改用普通patch方法 #

如果文档体积不大，无需依赖incrementalPatch的增量更新特性，可以直接替换为RxDB的常规patch方法，该方法对嵌套对象的处理逻辑更稳定：

await doc.patch({
    ...newDoc,
    updated_at: new Date().toUTCString(),
});

方案2：在schema中明确标记无需populate #

修改location字段的schema定义，添加ref: false属性，强制告知RxDB该字段及内部属性不需要执行populate操作：

location: {
    type: 'object',
    ref: false, // 明确标记为非引用字段，跳过populate检查
    properties: {
        altitude: { type: 'number' },
        latitude: { type: 'number' },
        longitude: { type: 'number' },
    },
},

方案3：拆分嵌套属性更新（保留incrementalPatch） #

如果必须使用incrementalPatch优化大文档更新，可以避免直接替换整个location对象，而是逐个更新内部需要修改的属性：

const updatePayload = {
    updated_at: new Date().toUTCString(),
};

// 仅添加实际需要更新的location子属性
if (newDoc.location) {
    Object.entries(newDoc.location).forEach(([key, value]) => {
        if (value !== undefined) {
            updatePayload[`location.${key}`] = value;
        }
    });
}

await doc.incrementalPatch(updatePayload);

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