matchedcount: 0 表示未匹配到任何文档，需优先检查过滤条件：字段类型不一致（如1与"1"）、$exists: false仅匹配字段不存在、集合/字段名拼写及大小写错误、嵌套路径错误等。
updateMany 返回 matchedCount: 0 是最直接的信号
调用 updateMany() 后拿到结果对象里 matchedCount 为 0，说明根本没找到任何文档——不是更新失败，是“压根没找着”。这时候再检查更新逻辑或操作符毫无意义，得先回到过滤条件本身。
字段值类型不一致是最隐蔽的坑
MongoDB 对类型敏感，1 和 "1"、null 和 undefined、ObjectId("...") 和字符串形式的 ID，全部不相等。常见误配场景包括：
- 数据库里
log_type存的是字符串"1"，但查询写了{ log_type: 1 } - 前端传来的 ID 是字符串
"64a6397b307445c9e7083401"，没转成ObjectId就直接塞进 filter - 字段实际是
NumberInt(1)（尤其在旧 shell 或某些导入工具下），而查询用了普通数字字面量，可能因驱动版本差异导致匹配失败
验证方法：先用 findOne() 查一条疑似目标文档，确认字段值和类型：
db.collection.findOne({ _id: ObjectId("...") }) 看输出里的字段值是否带引号、是否为 ObjectId、是否为 null。
$exists: false 不等于“字段为空”
这个误区高频出现。{ field: { $exists: false } } 只匹配**字段完全不存在**的文档；如果字段存在但值是 null、""、[] 或 {}，它不会被选中。
要覆盖“逻辑上为空”的所有情况，得显式组合：
{ $or: [ { field: { $exists: false } }, { field: null }, { field: "" } ] }
注意：null 匹配 null 和 undefined，但不匹配空字符串或空数组；"" 必须单独列出来。
集合名、字段名拼写和大小写必须完全一致
字段名区分大小写，且 MongoDB 不做自动纠错。比如文档里存的是 log_catagory（少了个 e），但查询写了 log_category，就一定不匹配。
常见漏点：
- Node.js 驱动里集合名写死成字符串
'collectionName'，而不是传入的变量collectionName - 嵌套字段路径写错层级，如把
user.profile.name写成user.name - 使用了中文引号、全角字符或不可见 Unicode 字符（尤其从 Word 或网页复制代码时）
建议：直接从 findOne() 返回的文档里 copy 字段名，避免手敲出错。
find()，比反复改 $set 更有效。
