Mongoose查询本地正常但AWS生产环境返回空数组问题排查

核心结论 #

该问题和Ubuntu系统版本、MongoDB/Mongoose版本差异无关，本质是Schema默认值计算逻辑无容错 + Mongoose 5.x版本文档实例化阶段静默吞错 + 生产环境存在历史脏数据三者共同导致，本地环境因测试数据集无脏数据未触发异常。

触发逻辑拆解 #

• 当查询投影包含totalNumberOfCarsOwned字段时，Mongoose 5.4.x版本在将MongoDB返回的原始记录转换为Mongoose文档实例的过程中，无论数据库中该字段是否已有存储值，都会执行定义的默认值函数做字段补全校验；如果投影排除该字段，这段计算逻辑完全不会触发。
• 生产环境Users集合存在历史脏数据：部分文档的carsOwned数组条目中，brand字段存在类型异常（不是数组、为null/undefined），默认值函数执行car.brand.length时会直接抛出TypeError: Cannot read property 'length' of undefined的同步错误。
• Mongoose 5.x版本对findOne查询文档实例化阶段抛出的未捕获同步错误做了静默处理，不会将错误抛出到查询回调，直接返回空结果，这也是看不到明确报错、仅拿到空数组的核心原因。
• 本地环境的测试数据均为规范结构，不存在brand字段类型异常的问题，因此默认值函数可以正常执行，查询表现正常。

验证步骤 #

1. 直接在生产环境Mongo实例执行查询，定位脏数据：

// 查询所有carsOwned下brand字段不是数组的异常文档
db.users.find({
  "carsOwned.brand": { $not: { $type: "array" } }
})

2. 给默认值函数增加错误捕获，可直接复现之前被静默吞掉的报错：

totalNumberOfCarsOwned: {
  type: Schema.Types.Number,
  default: function () {
    try {
      let carsCount = 0;
      for (let car of this.carsOwned) {
        // 增加类型判断，跳过异常条目
        if (!car || !Array.isArray(car.brand)) continue
        carsCount += car.brand.length;
      }
      return carsCount
    } catch (err) {
      // 此处打印日志可看到之前被吞掉的类型错误
      console.error('totalNumberOfCarsOwned计算异常', err, this._id)
      return 0
    }
  }
}

增加上述容错后，即使不显式做字段投影排除totalNumberOfCarsOwned，查询也可正常返回结果。

永久修复方案 #

• 清洗生产环境脏数据：遍历所有异常文档，将carsOwned条目下类型异常的brand字段修正为空数组，补全缺失字段。
• 所有Schema中涉及跨字段计算的默认值、getter/setter逻辑，必须增加全链路边界容错，不要假设关联字段一定存在、类型一定符合预期，避免单条脏数据导致整条查询失效。
• 不建议在默认值函数中做跨字段的实时统计，这类计数类字段建议通过pre('save')/pre(findOneAndUpdate)等钩子在写入时计算更新，避免查询阶段触发不必要的计算逻辑。

内容的提问来源于stack exchange，提问作者Mr.J