Node/Express+Mongoose中MongoDB聚合查询无结果问题排查

可能的原因及对应解决方法 #

1. 正则表达式未转义特殊字符 #

直接将用户输入转为正则时，若输入包含.、*、+等正则元字符，会导致匹配逻辑失效，查不到结果。

• 解决：用RegExp.escape()转义用户输入后再构造正则：

  const searchKeyword = req.query.search;
  const titleRegex = new RegExp(RegExp.escape(searchKeyword), 'i'); // 'i'开启大小写忽略
  

2. 聚合管道$match阶段写法错误 #

可能存在字段名大小写不匹配（比如数据库存的是title，代码里写了Title），或者正则使用方式错误。

• 正确的聚合匹配示例：

  const matchedMovies = await Movie.aggregate([
    { $match: { title: titleRegex } },
    { $limit: 5 }
  ]);
  

3. 路由逻辑错误触发404 #

若查询返回空数组时，错误调用了next()或直接返回404，而非返回空数组响应。

• 错误示例：

  if (matchedMovies.length === 0) {
    next(); // 触发404中间件
  }
  

• 修正：

  res.json(matchedMovies); // 即使结果为空，也返回空数组而非404
  

4. 缺少错误捕获导致无日志 #

聚合查询可能抛出错误，但未添加try/catch捕获，错误被Express默认处理，直接跳404且无日志输出。

• 解决：给路由添加错误捕获：

  router.get('/search', async (req, res) => {
    try {
      if (req.query.search) {
        const titleRegex = new RegExp(RegExp.escape(req.query.search), 'i');
        const matchedMovies = await Movie.aggregate([
          { $match: { title: titleRegex } },
          { $limit: 5 }
        ]);
        return res.json(matchedMovies);
      } else {
        const latestMovies = await Movie.aggregate([{ $limit: 10 }]);
        return res.json(latestMovies);
      }
    } catch (err) {
      console.error('搜索查询异常:', err);
      res.status(500).json({ msg: '服务器查询失败' });
    }
  });
  

5. 数据库无匹配数据 #

直接在MongoDB客户端执行相同聚合语句，验证是否存在匹配文档：

db.movies.aggregate([
  { $match: { title: /你的测试关键词/i } },
  { $limit: 5 }
])

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