MongoDB修改对象字段名后，如何让变更流识别该变更？

1. 未实际创建变更流游标 #

modifyChangeStreams命令仅用于启用/禁用集合的变更流支持（默认情况下集合已启用变更流，除非手动禁用过），但要捕获变更事件，你需要创建变更流游标来监听事件。

执行以下命令启动监听：

const changeStream = db.collection.watch();
// 遍历游标获取事件
changeStream.forEach(event => {
  printjson(event);
});

2. 变更流未监听renamedFields字段 #

使用$rename操作时，变更事件的updateDescription中会通过renamedFields字段记录字段重命名，而非updatedFields。如果你的监听代码只检查updatedFields，会错过这类变更。

典型的重命名事件结构：

{
  "operationType": "update",
  "updateDescription": {
    "renamedFields": { "audit": "audit1" },
    "removedFields": [],
    "updatedFields": {}
  },
  // 其他事件字段...
}

3. MongoDB部署环境不支持变更流 #

变更流依赖MongoDB的Oplog（操作日志），仅在副本集或分片集群环境下可用。如果你的MongoDB是单实例部署，即使启用变更流，也不会生成任何变更事件。

解决方法：将单实例转换为副本集部署。

4. 更新操作未实际修改文档 #

如果集合中部分/全部文档的audit字段已经不存在或已名为audit1，updateMany不会对这些文档产生变更事件（变更流仅捕获实际发生修改的文档）。

可以通过检查updateMany的返回结果确认修改数量：

const result = db.collection.updateMany({}, {$rename: {"audit":"audit1"}});
print(`修改的文档数量：${result.modifiedCount}`);

如果modifiedCount为0，说明没有文档被实际修改，自然不会有变更事件。

5. 集合/数据库名称拼写错误 #

检查modifyChangeStreams命令中的database和collection参数是否与你执行updateMany的目标数据库、集合完全一致（MongoDB对名称大小写敏感，除非部署时修改了配置）。

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