在Express.js中为单个路由将请求体解析为文本

嘿，这个场景太常见了——全局配置了JSON解析，但总有那么一两个路由需要特殊处理对吧？别担心，Express的中间件执行机制刚好能完美解决这个问题，下面给你两种实用的解决方案：

方法一：优先为目标路由挂载文本解析中间件 #

这种方法利用了Express中间件按注册顺序执行的特性，我们先为需要文本解析的路由单独挂载解析逻辑，再全局应用JSON解析。这样目标路由的请求会先被文本解析处理，后续的全局JSON解析会自动跳过（因为请求体已经被解析过了）。

示例代码：

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

// 第一步：先给需要特殊处理的路由挂载文本解析
app.post('/special-text-route', express.text(), (req, res) => {
  console.log(typeof req.body); // 输出 'string'
  res.send(`收到文本内容：${req.body}`);
});

// 第二步：全局挂载JSON解析（会应用到除上面路由外的所有其他路由）
app.use(express.json());

// 普通JSON解析路由示例
app.post('/normal-json-route', (req, res) => {
  console.log(typeof req.body); // 输出 'object'
  res.json({ 接收的数据: req.body });
});

app.listen(3000, () => console.log('服务运行在3000端口'));

额外配置说明 #

如果需要自定义文本解析的规则，可以给express.text()传配置参数：

// 指定编码、限制请求体大小，或者强制解析所有Content-Type类型
app.post('/special-route', express.text({
  defaultCharset: 'utf-8',
  limit: '2mb',
  type: '*/*' // 不管请求头的Content-Type，都解析为文本
}), (req, res) => {
  // 处理逻辑
});

方法二：通过条件判断跳过全局JSON解析 #

如果你已经先全局挂载了JSON解析，不想调整中间件的注册顺序，可以用这种方法：自己封装一个中间件，判断请求是否是目标路由，是的话就跳过JSON解析，再单独为目标路由挂载文本解析。

示例代码：

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

// 自定义全局JSON解析中间件，跳过目标路由
app.use((req, res, next) => {
  // 判断请求路径和方法，匹配目标路由则跳过JSON解析
  if (req.path === '/special-text-route' && req.method === 'POST') {
    return next();
  }
  // 其他路由正常应用JSON解析
  express.json()(req, res, next);
});

// 为目标路由单独挂载文本解析
app.post('/special-text-route', express.text(), (req, res) => {
  console.log(typeof req.body); // 'string'
  res.send(`文本内容已接收：${req.body}`);
});

// 普通JSON路由示例
app.post('/normal-json-route', (req, res) => {
  console.log(typeof req.body); // 'object'
  res.json({ 数据: req.body });
});

app.listen(3000);

灵活匹配路由 #

如果你的目标路由包含参数或者需要正则匹配，可以调整判断逻辑：

// 匹配所有以/special开头的POST请求
if (req.path.match(/^\/special/) && req.method === 'POST') {
  return next();
}

两种方法都能完美实现你的需求，选哪种就看你的代码结构和个人习惯啦～

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