Express为何将&转为&amp%3B？该如何处理此问题？

DevOps 小满

2026-5-21

解决Express中查询字符串amp;campaignId参数异常的问题

嘿，这个问题我之前也碰到过！其实这大概率不是Express的配置问题，而是查询字符串被双重编码搞出来的麻烦，咱们一步步拆解解决：

问题根源

你收到的请求链接里原本的&被转成了HTML实体&，之后这个实体又被做了URL编码，变成了&amp%3B。Express的查询解析器（默认用qs库）会把这个当成参数名的一部分，所以就出现了'amp;campaignId':'123456'这种异常参数。

解决步骤

1. 优先从请求源头修复（最推荐）

这种情况大多是前端生成URL时的问题：比如在HTML的href属性里直接写了&，或者前端JS拼接URL时错误地使用了HTML实体而非原始的&。

正确的做法是：拼接查询参数时直接用原始的&，比如生成的URL应该是https://myserver.com/processCampaign?id=12345679&campaignId=123456，而不是带&的版本。

2. 后端中间件修复（如果无法修改请求源头）

如果是第三方请求或者没法改前端，咱们可以在Express里加一个前置中间件，手动修复编码后的查询字符串：

// 这个中间件要放在express.json()/express.urlencoded()之前
app.use((req, res, next) => {
  // 把被双重编码的&amp%3B替换回&
  req.url = req.url.replace(/&amp%3B/g, '&');
  // 或者更通用的处理：先解码URL，再替换HTML实体
  // req.url = decodeURIComponent(req.url).replace(/&amp;/g, '&');
  next();
});

这样处理后，Express就能正常解析出id和campaignId两个参数了。

3. 检查Express查询解析配置（排查项）

Express默认用qs库解析查询字符串，默认配置是没问题的。如果你手动修改过query parser配置（比如设置了app.set('query parser', 'simple')，用Node原生querystring模块），可以改回默认的qs模式，不过这一般不是导致这个问题的原因。