Node.js中url.format方法仅编码URL参数、避免查询字符串被编码的解决方案咨询

这个问题我之前也碰到过——url.format()默认会对查询参数做严格的URL编码，把+转成%2B，但有时候我们就是想保留原始的+符号。下面给你两个可行的解决方案：

方案一：手动设置search属性绕过自动编码 #

当你直接给解析后的URL对象设置query属性时，url.format()会自动把这个对象序列化成查询字符串并编码。想要避免这个行为，你可以跳过query，直接设置search属性，手动写好你想要的原始查询字符串：

const url = require('url');

const parsedUrl = url.parse('localhost://0.0.0.0/products', true);
// 直接指定search属性，用原始格式的查询字符串
parsedUrl.search = '?query=foo+bar';
// 如果原有查询参数需要保留，记得自己合并，比如：parsedUrl.search = '?existing=param&query=foo+bar'

const formattedUrl = url.format(parsedUrl);
console.log(formattedUrl); // 输出：localhost://0.0.0.0/products?query=foo+bar

方案二：使用新版URL API（Node.js v10+） #

如果你用的是较新版本的Node.js，推荐使用标准的URL类，同样通过直接设置search属性来保留原始格式：

const { URL } = require('url');

const myUrl = new URL('localhost://0.0.0.0/products');
// 直接赋值search，跳过自动编码步骤
myUrl.search = '?query=foo+bar';

console.log(myUrl.toString()); // 输出：localhost://0.0.0.0/products?query=foo+bar

原理说明 #

url.format()的逻辑是：如果检测到URL对象有query属性，就会自动调用查询参数编码逻辑；但如果已经设置了search属性，它会直接使用这个字符串，不会再做编码处理。这就是我们能保留原始+的关键。

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