Express路由参数中UTF-8特殊字符的处理问题

嘿，我之前也踩过这个坑！这本质上是URL路径参数的编码/解码机制在不同请求类型下的客户端处理差异，加上Express默认配置的小细节导致的。咱们来一步步搞定它：

为什么会出现这个问题？ #

• GET请求的特殊性：当你在Postman里直接输入带UTF-8特殊字符的URL（比如/api/â），Postman会自动对路径进行URL编码（â会变成%C3%A2），但Express在解析req.params.id时，默认依赖Node.js的url模块解码——大多数情况下没问题，但如果客户端的编码方式和Node.js的解码逻辑不匹配（比如某些工具用了非UTF-8编码），就会出现乱码。
• POST请求的差异：虽然你的POST路由同样用路径参数，但Postman处理POST请求URL时，可能采用了不同的编码策略，导致解析结果和GET请求不一致。

具体解决方案 #

1. 强制Express使用UTF-8解码路径参数 #

我们可以通过中间件手动处理参数解码，确保UTF-8字符被正确解析：

const express = require('express');
const app = express();

// 自定义中间件：解码路径参数为UTF-8
app.use((req, res, next) => {
  if (req.params.id) {
    // 使用decodeURIComponent确保UTF-8字符解码正确
    req.params.id = decodeURIComponent(req.params.id);
  }
  next();
});

// 你的路由配置
const router = express.Router();
router.get('/:id', (request, response) => {
  console.log('GET 解析后的ID:', request.params.id);
  response.send(request.params.id);
});
router.post('/:id', (request, response) => {
  console.log('POST 解析后的ID:', request.params.id);
  response.send(request.params.id);
});

app.use('/api', router);
app.listen(3000);

2. 确保客户端发送正确编码的URL #

不管是GET还是POST，都应该使用已编码的URL发起请求：

• 比如â对应的URL编码是%C3%A2，正确的请求URL应为http://localhost:3000/api/%C3%A2
• Postman通常会自动编码特殊字符，但如果遇到异常，手动输入编码后的字符串测试会更准确。

3. 统一请求头编码设置 #

确保请求的Content-Type头包含charset=utf-8，例如：

Content-Type: application/json; charset=utf-8

虽然路径参数解码和请求体无关，但统一编码设置能避免很多隐性问题。

测试验证 #

现在用Postman测试：

• 发送GET请求到http://localhost:3000/api/â，控制台应输出正确的â
• 发送POST请求到同一个URL，控制台也会输出正确的â

这样就能解决GET和POST请求中UTF-8特殊字符ID的解析差异问题啦！

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