Node.js REST GET接口接收多查询参数通过Mongoose find实现动态筛选

问题根因 #

你现在的写法里$or: [q]完全没有意义：$or的作用是匹配数组中任意一个条件，你把所有筛选参数都封装到单个q对象里塞进长度为1的数组，和直接传q作为查询条件没有任何区别，完全没用到$or的逻辑。

场景1：需要满足所有传入的筛选条件（AND关系，90%的筛选场景都是这个需求） #

直接把你构建好的q对象传给find()即可，不需要加$or。
优化后的代码示例：

app.get('/venta',  async (req, res) =>{
    // 构建查询条件：只保留实际传入的参数
    const query = {};
    const { anio, fecha, cajas } = req.query;
    if(anio) query.anio = anio;
    if(fecha) query.fecha = fecha;
    if(cajas) query.cajas = cajas;

    try {
        // 直接传query作为find的参数，会自动按AND关系匹配所有传入的条件
        const ventas = await Venta.find(query);
        return res.json({
            ok: true,
            ventas
        })
    } catch (err) {
        return res.status(400).json({
            ok: false,
            mensaje: 'no se encontro las ventas'
        })
    }
})

如果后续要加更多筛选参数，不想一个个写if判断，可以用白名单过滤的方式更简洁：

// 可以随便加允许查询的字段，不需要修改后续逻辑
const allowFields = ['anio', 'fecha', 'cajas', 'nombre', 'monto']; 
const query = allowFields.reduce((acc, field) => {
    if(req.query[field] !== undefined) {
        // 如果是数字类型的字段，这里可以加类型转换：acc[field] = Number(req.query[field])
        acc[field] = req.query[field];
    }
    return acc;
}, {});

场景2：确实需要满足任意一个传入的筛选条件（OR关系） #

需要把每个传入的参数单独作为$or数组的元素，而非封装成一个对象塞进数组：

app.get('/venta',  async (req, res) =>{
    const orConditions = [];
    const { anio, fecha, cajas } = req.query;
    if(anio) orConditions.push({ anio });
    if(fecha) orConditions.push({ fecha });
    if(cajas) orConditions.push({ cajas });

    // 如果没有传入任何参数，就查询所有数据
    const query = orConditions.length ? { $or: orConditions } : {};

    try {
        const ventas = await Venta.find(query);
        return res.json({
            ok: true,
            ventas
        })
    } catch (err) {
        return res.status(400).json({
            ok: false,
            mensaje: 'no se encontro las ventas'
        })
    }
})

额外注意点 #

• 你原代码里路由加了async关键字，但用的是exec回调写法，建议统一用await写法更简洁，也更容易处理错误
• 注意参数类型匹配：如果anio、cajas是Mongoose schema中定义的Number类型，req.query拿到的是字符串，需要手动转成数字再存入查询条件，否则会因为类型不匹配查不到结果
• 如果需要模糊查询，可以把对应字段的条件改成正则，比如query.anio = new RegExp(anio, 'i')

内容的提问来源于stack exchange，提问作者Damian Gabriel Lacava