Express.js路由URL请求中无法保留特殊字符+的问题

问题根源 #

你碰到的这个情况是URL编码的标准规则导致的：在URL的查询参数里，+符号会被默认解析为空格。Express框架默认使用的查询参数解析器（不管是qs还是旧版的querystring库）都会遵循这个规则，所以你原本的VITAMINS + ZINC...就变成了VITAMINS ZINC...。

解决方案 #

1. 前端请求时正确编码+符号

这是最标准、推荐的做法。在发起请求前，把查询关键词里的+替换成它的URL编码形式%2B，或者直接用编码方法处理整个关键词。

比如你的请求URL应该修改为：

http://localhost:4200/api/search?key=VITAMINS%20%2B%20ZINC%20100MG/10MG%20PER%205ML%20SYRUP

如果是用JavaScript发起请求，直接用encodeURIComponent()方法处理搜索关键词，它会自动把所有特殊字符（包括+）转成正确的编码：

const searchKeyword = "VITAMINS + ZINC 100MG/10MG PER 5ML SYRUP";
const encodedKeyword = encodeURIComponent(searchKeyword);
const requestUrl = `http://localhost:4200/api/search?key=${encodedKeyword}`;
// 这里发起你的请求即可

2. 后端手动处理原始查询字符串（应急方案）

如果你暂时无法修改前端代码，可以在后端直接读取原始的URL查询部分，绕过Express默认的解析逻辑来保留+。

示例代码如下：

router.get('/search', (req, res, next) => {
  // 从原始URL中提取查询字符串部分
  const rawQueryString = req.originalUrl.split('?')[1];
  if (!rawQueryString) {
    // 没有查询参数的情况，自行处理
    return res.status(400).send('Missing search key');
  }
  
  // 手动提取key参数的值，并处理+符号
  const keyMatch = rawQueryString.match(/key=(.*)(?:&|$)/);
  if (keyMatch) {
    // 先把+转成%2B，再解码，避免被当成空格
    const searchKey = decodeURIComponent(keyMatch[1].replace(/\+/g, '%2B'));
    console.log(searchKey); // 输出：VITAMINS + ZINC 100MG/10MG PER 5ML SYRUP
    // 后续业务逻辑...
  }
});

不过这个方案有局限性：如果你的查询参数里原本就有空格，这种替换会把原空格也变成+，所以只适合应急，长期来看还是推荐前端正确编码。

内容的提问来源于stack exchange，提问作者Shift 'n Tab