Node.js服务中字符串查询参数被解析为数组是什么原因导致的？

• AWS Lambda 侧的常见原因 #

如果你的Lambda是通过API Gateway触发，90%的概率是启用了多值查询参数支持：

当API Gateway开启多值查询参数配置后，所有查询参数都会被封装到multiValueQueryStringParameters字段中，无论参数是否重复，取值统一为数组格式。
排查方法：打印Lambda的完整event对象，优先取值queryStringParameters字段而非multiValueQueryStringParameters即可得到字符串类型的参数值。

• Express 侧的常见原因 #

Express默认使用qs库解析查询参数，默认配置下单个非重复参数会返回字符串，出现数组的可能原因如下：

1. 手动修改了查询解析器的全局配置，开启了强制数组解析，比如配置了app.set('query parser', (str) => qs.parse(str, { parseArrays: true }))
2. 项目依赖的第三方中间件（请求监控、日志打点、参数校验类中间件）修改了默认的req.query/req.params挂载逻辑，重写了参数值的格式
3. 反向代理/网关层重复追加了查询参数，导致实际到达Express服务的请求链接为https://somedomain.com/test?first=val&first=val，重复参数会被自动解析为数组
   排查方法：

• 打印req.originalUrl确认原始请求的查询参数格式是否符合预期
• 手动指定qs解析配置，强制关闭数组解析即可修复：

// Express 4.x+ 配置示例
const qs = require('qs')
app.set('query parser', (queryString) => {
  return qs.parse(queryString, {
    parseArrays: false,
    comma: false,
    allowPrototypes: false
  })
})

• 跨环境通用排查点 #

如果两个无关联服务同时出现该问题，优先排查是否两个项目都依赖了同一个修改查询参数解析逻辑的公共npm包，或者部署层的统一网关是否开启了全局的参数格式转换配置。

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