如何使用NodeJS内置node:querystring模块解析查询字符串参数？

你遇到的问题是因为querystring.parse仅用于解析纯查询字符串，而非完整URL——它会直接按&和=分割传入的整个字符串，所以才会把URL开头的https://www.test.com/?utm_campaign当成键。

以下是两种更可靠的内置解决方案：

方案1：使用node:url模块的URL类（推荐） #

这是Node.js官方推荐的现代方式，能完整解析URL结构并便捷处理查询参数：

const urlStr = 'https://www.test.com/?utm_campaign=1%25+LAL&utm_content=Test+Video&fbclid=s3XjT0ggIZq6o';
const { URL } = require('node:url');

const parsedUrl = new URL(urlStr);
// 直接操作查询参数（URLSearchParams对象）
console.log(parsedUrl.searchParams.get('utm_campaign')); // 输出 '1% LAL'

// 转换为普通对象
const queryParams = Object.fromEntries(parsedUrl.searchParams);
console.log(queryParams);
/* 输出：
{
  utm_campaign: '1% LAL',
  utm_content: 'Test Video',
  fbclid: 's3XjT0ggIZq6o'
}
*/

方案2：使用node:url模块的parse方法（兼容旧版本） #

如果需要兼容Node.js旧版本，可以用url.parse，记得传入第二个参数true来自动解析查询字符串：

const urlStr = 'https://www.test.com/?utm_campaign=1%25+LAL&utm_content=Test+Video&fbclid=s3XjT0ggIZq6o';
const { parse } = require('node:url');

const parsedResult = parse(urlStr, true);
console.log(parsedResult.query);
/* 输出：
{
  utm_campaign: '1% LAL',
  utm_content: 'Test Video',
  fbclid: 's3XjT0ggIZq6o'
}
*/

如果一定要用querystring模块 #

需要先手动提取URL中的查询字符串部分（?之后的内容）：

const urlStr = 'https://www.test.com/?utm_campaign=1%25+LAL&utm_content=Test+Video&fbclid=s3XjT0ggIZq6o';
const querystring = require('node:querystring');

const queryPart = urlStr.split('?')[1] || '';
const params = querystring.parse(queryPart);
console.log(params);
/* 输出：
{
  utm_campaign: '1% LAL',
  utm_content: 'Test Video',
  fbclid: 's3XjT0ggIZq6o'
}
*/

这种方法需要自行处理URL中不含?的情况，不如前两种方案健壮。

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