MongoDB调用find添加条件查询无法获取匹配数据问题

问题复现 #

• 基于next-connect开发服务端接口时，无查询条件的全量拉取逻辑可以正常返回MongoDB中mountain集合的所有数据，实现代码如下：

import nextConnect from 'next-connect';
import middleware from '../database';

const handler = nextConnect();

handler.use(middleware);

handler.get(async (req, res) => {

    let doc = [];

    await req.db.collection("mountain").find().forEach(element => {
        doc.push(element);
    });
    console.log(doc);
    res.json(doc);
});

export default handler;

• 给find()方法添加{name: "Lion Rock"}精确匹配条件后，无法获取到匹配的目标数据，条件查询实现代码如下：

import nextConnect from 'next-connect';
import middleware from '../database';

const handler = nextConnect();

handler.use(middleware);

handler.get(async (req, res) => {

    let doc = await req.db.collection("mountain").find({ name: "Lion Rock" })
    console.log(doc);
    res.json(doc);
});

export default handler;

• mountain集合的实际存储数据结构如下：
  

故障原因 #

核心问题有两个：

1. 未正确处理MongoDB的查询返回值：MongoDB Node.js驱动中，find()方法执行后不会直接返回匹配的文档数组，而是返回一个指向结果集的游标（Cursor）对象。全量查询逻辑之所以能拿到数据，是因为手动调用了游标的forEach方法遍历所有结果、逐行push到数组中；而条件查询的代码直接将await find()返回的游标对象赋值给变量返回，根本没有拿到实际的文档内容，自然无法得到预期结果。
2. 手动forEach遍历游标转数组的写法冗余，容易遗漏异步逻辑导致数据异常，官方推荐直接调用游标提供的toArray()方法获取结果数组。

修复方案 #

将查询逻辑修改为调用toArray()转换游标结果即可，修正后的代码如下：

import nextConnect from 'next-connect';
import middleware from '../database';

const handler = nextConnect();

handler.use(middleware);

handler.get(async (req, res) => {
    // 调用toArray()将游标转换为实际的文档结果数组
    let doc = await req.db.collection("mountain").find({ name: "Lion Rock" }).toArray();
    console.log(doc);
    res.json(doc);
});

export default handler;

如果执行上述代码后仍未查询到数据，可额外排查两点：

• 核对name字段的实际存储值是否存在大小写差异、前后不可见空格，若存在格式差异可调整查询条件，或使用$regex操作符做适配匹配。
• 确认当前数据库连接指向的环境、集合名称正确，避免连错测试/生产环境导致查询结果不符合预期。

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