Express JS如何基于请求头参数实现路由管理

核心思路是通过自定义中间件读取appName请求头，直接将请求转发到对应客户端的路由组，无需修改原有路由的内部定义，即可实现去除URL前缀的需求。

完整实现代码 #

const express = require('express');
const app = express();
const webRoute = require('./src/routes/web/index')
const cmsRoute = require('./src/routes/cms/index');

// 路由分发中间件
const routeDispatcher = (req, res, next) => {
  // express会自动将请求头的键转为全小写，此处必须用全小写的appname读取
  const appName = req.headers.appname?.toLowerCase();
  switch(appName) {
    case 'web':
      // 直接调用web路由处理请求
      return webRoute(req, res, next);
    case 'cms':
      // 直接调用cms路由处理请求
      return cmsRoute(req, res, next);
    default:
      return res.status(400).json({
        code: 400,
        message: '请求头缺失合法appName参数'
      });
  }
};

// 公共路由（无需区分客户端的接口）优先注册，例如健康检查
app.get('/health', (req, res) => res.send('success'));

// 根路径挂载分发中间件，无需设置/web、/cms前缀
app.use('/', routeDispatcher);

// 其他全局中间件、错误处理逻辑保持不变
app.listen(3000, () => {
  console.log('服务运行在端口3000');
});

可选扩展：增加appKey校验 #

如果需要同时校验请求头的appKey合法性，可在分发中间件中增加校验逻辑：

const validAppKeys = {
  web: 'web端预设的合法appKey',
  cms: 'cms端预设的合法appKey'
};

const routeDispatcher = (req, res, next) => {
  const appName = req.headers.appname?.toLowerCase();
  const appKey = req.headers.appkey;

  if (!appName || !validAppKeys[appName] || validAppKeys[appName] !== appKey) {
    return res.status(401).json({
      code: 401,
      message: 'appName或appKey非法'
    });
  }

  switch(appName) {
    case 'web':
      return webRoute(req, res, next);
    case 'cms':
      return cmsRoute(req, res, next);
  }
};

注意事项 #

• 原有webRoute、cmsRoute内部的路由代码完全不需要修改，原/web/user/profile对应的接口现在直接请求/user/profile携带appName: web请求头即可正常访问
• 如果需要兼容原有带前缀的URL请求，可以在分发中间件之前增加路径前缀解析逻辑，将路径中带的/web、/cms前缀转为对应appName即可实现双模式兼容

内容的提问来源于stack exchange，提问作者shev anto