MongoDB模糊查询用户问题：无匹配时未返回指定错误信息

一、指定字段部分字符串匹配的最佳实现 #

针对 MongoDB（Mongoose） #

直接使用 MongoDB 的 $or 逻辑操作符结合 $regex 实现多字段模糊匹配，支持大小写不敏感查询：

const User = require('../models/User');

async function searchUsers(req, res) {
  const { query } = req.query;
  
  // 构造多字段模糊匹配条件
  const matchCondition = {
    $or: [
      { name: { $regex: query, $options: 'i' } }, // 'i' 表示不区分大小写
      { username: { $regex: query, $options: 'i' } }
    ]
  };

  // 执行查询
  const users = await User.find(matchCondition);
  res.json(users);
}

针对 SQL（Sequelize） #

利用 Sequelize 的 Op.or 和 Op.like 操作符实现类似逻辑：

const { User } = require('../models');
const { Op } = require('sequelize');

async function searchUsers(req, res) {
  const { query } = req.query;
  
  const users = await User.findAll({
    where: {
      [Op.or]: [
        { name: { [Op.like]: `%${query}%` } },
        { username: { [Op.like]: `%${query}%` } }
      ]
    }
  });

  res.json(users);
}

二、修复“用户未找到”错误返回问题 #

问题根源是原有代码可能在查询结果为空时主动抛出了 404 错误，只需移除空结果判断逻辑即可：

错误示例（需要修改） #

// 错误逻辑：空结果时返回错误
const users = await User.find(matchCondition);
if (!users.length) {
  return res.status(404).json({ error: '用户未找到' });
}
res.json(users);

正确逻辑 #

直接返回查询结果，空结果时自动返回空数组，无需额外错误处理：

const users = await User.find(matchCondition);
res.json(users); // 无匹配时返回 []，而非错误信息

如果是全局错误中间件误将空结果判定为错误，需检查中间件逻辑，确保仅捕获数据库连接异常、语法错误等真正的操作错误，而非查询结果为空的情况。

额外优化建议 #

• 参数校验：若请求参数 query 为空字符串，可根据业务需求返回空数组或所有用户：

  if (!query?.trim()) {
    return res.json([]); // 或返回 User.find() 获取全部用户
  }
  

• 分页处理：用户量较大时，添加分页避免一次性返回过多数据：

  // Mongoose 示例
  const { query, page = 1, limit = 10 } = req.query;
  const skip = (page - 1) * limit;
  const users = await User.find(matchCondition).skip(skip).limit(parseInt(limit));
  

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