Express 如何获取 GET 请求的 URL 参数？

Express 获取 GET 查询参数用 req.query（如 /search?q=node → req.query.q）；路径参数用 req.params；表单 POST 体用 req.body。本文分清三者并给出完整示例。

观测云编辑部 2026-09-28 3 分钟阅读更新于 2026-09-28

查询字符串参数（?key=value）用 req.query；路由里的路径参数（/user/:id）用 req.params。

req.query：查询字符串

const express = require('express');
const app = express();
app.set("query parser", "simple");

// 访问 /example?param1=hello&param2=world
app.get('/example', (req, res) => {
  const param1 = req.query.param1;   // 'hello'
  const param2 = req.query.param2;   // 'world'
  res.json({ param1, param2 });
});

app.listen(3000);

不需要装任何东西，解析结果取决于 query parser；本例显式使用 simple。访问 /example?tag=a&tag=b 时 req.query.tag 是数组 ['a','b']。

req.params：路径参数

// 访问 /user/42
app.get('/user/:id', (req, res) => {
  res.json({ userId: req.params.id });   // 42
});

三者别搞混

来源	例子	取值
查询字符串	`/search?q=node`	`req.query.q`
路径参数	`/user/:id`	`req.params.id`
POST 表单体	表单提交	`req.body`（需中间件）

常见坑

不能假定所有 query 值都是字符串：重复键可成数组，扩展/自定义解析器还可能生成对象。数字参数先验证单一字符串、格式和范围，再 Number 转换并检查有限整数；
参数不存在是 undefined：给默认值 const page = req.query.page ?? 1；
用户输入不可信：query 参数直接用进 SQL/命令前先校验（SQL 注入、命令注入）。