Mongoose连接成功但Express get请求返回空数组如何排查

mongoose.connection.readyState返回1仅代表客户端与MongoDB服务端建立了网络连接，不代表已经连接到存储业务数据的目标库/目标集合。跨设备代码、权限配置完全一致但查询返回空数组，是非常典型的连接目标不匹配问题，按以下顺序排查即可定位：

• 校验实际连接的数据库名

  MongoDB Atlas生成的默认连接串不会携带业务库名，格式为mongodb+srv://<账号>:<密码>@cluster0.xxx.mongodb.net/?retryWrites=true&w=majority，这种情况下Mongoose会默认连接到名为test的空库。如果你旧设备的连接串末尾手动拼接了业务库名，新设备复制连接串时漏了这部分，就会连到空库返回空结果。
  在连接成功回调中加一行console.log('当前连接库名：', mongoose.connection.name)，和旧设备运行时打印的库名做比对，如果不一致，在连接串的mongodb.net/后、参数前补上你的业务库名即可，修正后格式参考：

  mongodb+srv://<账号>:<密码>@cluster0.xxx.mongodb.net/你的业务库名?retryWrites=true&w=majority
  

• 校验Model实际绑定的集合名
  Mongoose默认会将Model名称转为小写复数形式作为查询的目标集合名，比如Model名为Move时，默认查询的集合是moves。如果你的代码没有显式指定集合名，或者新旧代码Schema定义存在差异，就会匹配到不存在的空集合返回空数组。
  在查询逻辑前加一行console.log('当前绑定集合名：', Model.collection.name)，和MongoDB Atlas后台实际存储数据的集合名做比对，如果不一致，在Schema初始化时传入第三个参数显式指定集合名即可，示例：

  // 第三个参数填你Atlas后台真实的集合名
  const businessSchema = new mongoose.Schema({/* 你的字段定义 */}, { versionKey: false }, '真实集合名')
  const Model = mongoose.model('ModelName', businessSchema)
  

• 校验环境变量实际加载值
  不要仅凭配置文件内容判断环境变量一致，新设备上如果.env文件存放路径不对、存在全局系统环境变量重名覆盖，都会导致实际加载的DB_URI和预期不符。在执行mongoose.connect前直接打印console.log('当前使用的连接串：', DB_URI)，和旧设备打印的连接串逐字符比对，重点核对库名、账号密码部分。
• 修正现有代码的干扰性问题
  你当前的代码存在几处语法问题，会掩盖真实报错，先修正再排查：
  1. mongoose.connect的回调函数第一个参数是错误对象，不是(req, res)，现有写法连接出错时不会抛出异常，会误导你判断连接状态
  2. console.log、res.render都不是异步方法，不需要加await
  3. 第二版接口代码里打印的moves变量未定义，运行时会直接抛引用错误
     修正后的最小可运行参考代码：

  // 数据库连接逻辑
  mongoose.connect(
    DB_URI,
    { useNewUrlParser: true, useUnifiedTopology: true },
    (err) => {
      if (err) {
        console.error('数据库连接失败：', err)
        return
      }
      console.log('数据库连接成功，当前库名：', mongoose.connection.name)
      console.log('连接状态：', mongoose.connection.readyState)
    }
  )
  
  // 接口逻辑
  app.get("/path", (req, res) => {
    Model.find((err, data) => {
      if (err) {
        console.log('查询报错：', err)
        return res.status(500).send('查询失败')
      }
      console.log('当前查询集合：', Model.collection.name)
      console.log('查询结果：', data)
      res.render("pathView", { data: data })
    })
  })
  

运行后根据打印的库名、集合名就能直接定位问题，这类问题和设备本身无关，本质是连接目标和预期不一致导致的。

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