NodeJS Express中如何处理同键多查询参数的API端点？

问题原因 #

Express 默认使用 qs 库解析查询字符串，对于同名参数（如 ?lastname=Smith&lastname=Garcia），默认行为是保留最后一个值而非转为数组，所以你只能获取到 Garcia 而不是两个值的集合。

解决方案步骤 #

1. 配置Express的查询参数解析器 #

修改Express应用的配置，让qs库将同名参数自动解析为数组：

const express = require('express');
const qs = require('qs');

const app = express();

// 自定义查询参数解析规则，开启repeat模式解析同名参数为数组
app.set('query parser', (queryString) => {
  return qs.parse(queryString, { arrayFormat: 'repeat' });
});

这样配置后，当请求http://localhost:8081/api/employees/?lastname=Smith&lastname=Garcia时，req.query.lastname会被解析为数组['Smith', 'Garcia']。

2. 修改控制器逻辑处理数组参数 #

在getAll控制器中，需要兼容参数为单个字符串或数组的情况，同时通过参数化查询避免SQL注入风险：

exports.getAll = (req, res) => {
  let sql = 'SELECT * FROM Employees';
  const queryParams = [];
  const whereConditions = [];

  // 处理lastname参数
  if (req.query.lastname) {
    // 统一转为数组格式
    const lastnames = Array.isArray(req.query.lastname) ? req.query.lastname : [req.query.lastname];
    // 构建IN条件的占位符
    whereConditions.push(`lastname IN (${lastnames.map(() => '?').join(',')})`);
    // 将所有姓氏加入参数数组
    queryParams.push(...lastnames);
  }

  // 同理处理firstname、position等其他参数
  if (req.query.firstname) {
    const firstnames = Array.isArray(req.query.firstname) ? req.query.firstname : [req.query.firstname];
    whereConditions.push(`firstname IN (${firstnames.map(() => '?').join(',')})`);
    queryParams.push(...firstnames);
  }

  // 拼接WHERE条件
  if (whereConditions.length > 0) {
    sql += ' WHERE ' + whereConditions.join(' AND ');
  }

  // 执行数据库查询（这里假设你已配置好数据库连接）
  db.query(sql, queryParams, (err, results) => {
    if (err) {
      return res.status(500).json({ message: '查询失败', error: err.message });
    }
    res.status(200).json(results);
  });
};

3. 关键注意事项 #

• 避免SQL注入：永远不要直接将用户传入的参数拼接到SQL语句中，必须使用占位符?配合参数数组的方式，让数据库驱动自动完成参数转义。
• 兼容性：如果你的应用需要支持单个参数值（如?lastname=Smith），代码中的Array.isArray判断可以确保单个值也能正常转为数组处理，无需额外分支逻辑。

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