如何为Express路由添加元数据并通过router.stack读取？

一、自定义Metadata方法实现（推荐） #

Express默认的Router路由对象没有metadata方法，我们可以通过扩展Router的路由方法（get/post等）来添加这个功能，同时实现元数据的存储与读取。

1. 扩展Router，添加metadata功能 #

const express = require('express');
const router = express.Router();
const controller = require('../controllers/mycontroller');

// 扩展所有HTTP方法的路由定义逻辑
['get', 'post', 'put', 'delete'].forEach(method => {
  const originalMethod = router[method];
  router[method] = function(path, handler) {
    // 调用原方法创建路由
    const route = originalMethod.call(this, path, handler);
    
    // 给路由对象添加metadata方法，用于存储元数据
    route.metadata = function(metaData) {
      // 把元数据挂载到路由对象本身
      this._metadata = metaData;
      // 同时挂载到控制器handler上，方便控制器直接读取
      handler._metadata = metaData;
      return this; // 支持链式调用
    };
    
    return route;
  };
});

// 使用扩展后的方法定义路由并添加元数据
router.get('/', controller.home).metadata({title: 'Home Page', internal: true});
router.get('/about', controller.about).metadata({title: 'About Us', internal: false});

2. 遍历读取路由元数据 #

通过router.stack遍历路由时，直接从路由对象的_metadata属性获取：

router.stack.forEach(layer => {
  // 过滤出实际的路由层（排除中间件等）
  if (layer.route && layer.route._metadata) {
    const metadata = layer.route._metadata;
    console.log(`路由 ${layer.route.path} 的元数据:`, metadata);
  }
});

3. 控制器中获取元数据 #

有两种简单的方式：

• 直接读取handler自身的_metadata属性：

// controllers/mycontroller.js
exports.home = (req, res) => {
  const { title } = exports.home._metadata;
  res.render('home', { title });
};

• 或者通过中间件把元数据挂载到req对象（更灵活，适合多个控制器共享逻辑）：
  修改扩展Router的代码，添加一个中间件：

router[method] = function(path, handler) {
  // 新增中间件，用于将元数据挂载到req
  const metaMiddleware = (req, res, next) => {
    req.routeMetadata = {};
    next();
  };
  // 把中间件放在控制器前面
  const route = originalMethod.call(this, path, metaMiddleware, handler);
  
  route.metadata = function(metaData) {
    this._metadata = metaData;
    // 更新中间件逻辑，将元数据写入req
    this.stack[0].handle = (req, res, next) => {
      req.routeMetadata = metaData;
      next();
    };
    handler._metadata = metaData;
    return this;
  };
  
  return route;
};

控制器中通过req.routeMetadata获取：

exports.home = (req, res) => {
  const { title } = req.routeMetadata;
  res.render('home', { title });
};

二、关于bind()方案的说明 #

你设想的router.get('/', controller.home).bind(key: 'value');存在语法错误，且无法实现需求：

1. bind()是函数方法，而router.get()返回的是路由对象，不是控制器函数，调用bind()不会修改控制器的this指向。
2. 即使正确给控制器函数绑定上下文：

router.get('/', controller.home.bind({ title: 'Home Page', internal: true }));

控制器中确实可以通过this.title获取数据，但无法在router.stack中读取绑定的元数据——因为bind()返回的是包装函数，JavaScript不会暴露该函数内部绑定的上下文对象，外部无法直接获取。

因此，bind()方案仅能满足控制器内获取数据的需求，无法实现路由遍历读取元数据的功能，不推荐使用。

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