ExpressJS中如何访问名称含点号的query查询参数

Express 默认使用 qs 库解析查询字符串，会自动将参数名中的 . 识别为对象嵌套的层级分隔符，因此请求里的 hub.mode、hub.challenge、hub.verify_token 三个参数不会被解析为键名带点的平面对象属性，而是被组装成了 hub 字段下的嵌套属性，直接用 req.query["hub.challenge"] 自然会拿到 undefined。

默认配置下打印 req.query，实际结构如下：

{
  hub: {
    mode: "subscribe",
    challenge: "1409653872",
    verify_token: "myToken"
  }
}

方法1：按嵌套结构直接取值（无需修改框架配置） #

不需要调整任何全局配置，顺着解析后的嵌套结构取值即可，推荐搭配可选链写法避免空值报错：

static async appInstallOnGroupHookHandler(req, res) {
  // 从嵌套的hub对象下读取对应字段
  const hubChallenge = req.query.hub?.challenge;
  console.log(`Hub Challenge ${hubChallenge}`);

  const verificationToken = req.query.hub?.verify_token;
  console.log(`Hub Verification Token=${verificationToken}`);

  return res.status(200).send(hubChallenge ?? 'success');
}

方法2：修改Express查询解析配置，保留原始参数名 #

如果你希望所有查询参数都保持原始的带点键名，不做自动嵌套解析，可以修改Express的query parser配置为simple模式。该模式使用Node.js原生querystring模块解析参数，不会将.、[]识别为嵌套分隔符，会返回扁平的键值对结构：

const express = require('express')
const app = express()

// 配置查询解析器为simple模式，保留参数原始名称
app.set('query parser', 'simple')

配置完成后，原本写法req.query["hub.challenge"]就可以正常获取到对应参数值。

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