Mongoose查询指定文档数组字段长度无结果问题排查

示例文档结构如下：

{
  "_id": {
    "$oid": "626cf1ccb6da65761db4b146"
  },
  "ID_NUM": "ID=2796414693",
  "SET_ARRAY": [
    "sruMkdGUeRbWZz6FSz",
    "6U7ugxem7Y0/ellBUF"
  ],
  "__v": 0
}

问题复现 #

当前执行的代码逻辑：

1. 执行查询：const lens = await model.findOne({ ID_NUM: "ID=2796414693" })
2. 打印数组长度：console.log(lens.SET_ARRAY.length)
3. 运行后无报错、无任何输出

原因排查与解决方案 #

1. 优先排查空查询结果问题 #

无输出最常见的原因是查询条件没有匹配到任何文档，此时lens值为null，如果代码外层存在未打印异常的try/catch、或者异步逻辑没有做错误捕获，访问null.SET_ARRAY抛出的异常会被静默，不会打印到控制台。
先给查询结果加空值判断，同时加上.lean()让查询返回普通JS对象，避免Mongoose文档实例的属性访问异常：

const lens = await model.findOne({ ID_NUM: "ID=2796414693" }).lean()
if (!lens) {
  console.log("未匹配到对应ID_NUM的文档")
  return
}
console.log("SET_ARRAY数组长度：", lens.SET_ARRAY.length)

2. 数据库层面直接计算长度（推荐） #

如果数组字段存储的元素很多、文档整体体积大，不需要拉取整个文档到本地，可以直接用聚合管道在MongoDB层面计算数组长度，查询效率更高：

const [result] = await model.aggregate([
  { $match: { ID_NUM: "ID=2796414693" } },
  {
    $project: {
      _id: 0,
      arrayLen: { $size: "$SET_ARRAY" }
    }
  }
])
if (!result) {
  console.log("未匹配到对应ID_NUM的文档")
  return
}
console.log("SET_ARRAY数组长度：", result.arrayLen)

3. 其他常见坑点排查 #

• 检查Mongoose Schema定义：必须显式声明SET_ARRAY字段类型为Array或对应类型的数组（比如示例里是字符串数组，就声明为SET_ARRAY: [String]），未在Schema中声明的字段，Mongoose查询时会默认过滤，无法通过返回结果访问。
• 检查查询条件匹配性：确认传入的ID_NUM值和数据库存储的值完全一致，排查是否存在前后空格、大小写不一致、特殊字符转义问题。
• 检查异步语法：await关键字必须在被async标记的函数内使用，否则返回的是pending状态的Promise对象，直接访问属性会触发未捕获的异常，在部分运行环境下不会打印错误信息。

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