KeystoneJS中路由res.locals能否在中间件中使用及执行顺序调整问题

这问题我之前帮开发者排查过类似的，核心是你现在的中间件执行时机不对——keystone.pre('routes', middleware.initLocals) 是在所有路由处理逻辑之前就触发的，所以肯定拿不到路由里后续添加到 res.locals 的变量。要解决这个问题，关键是调整中间件和路由的执行顺序，下面给你几个可行的方案：

方案1：将依赖路由变量的中间件改为路由级中间件 #

如果你只需要在特定路由（比如/product-detail）之后执行中间件，直接把中间件挂载在路由的处理链里即可。Express会按顺序执行路由处理函数和后续中间件，这样路由先完成res.locals的赋值，中间件就能拿到变量了。

示例代码：

// index.js
exports = module.exports = function(app) {
  // 先挂载路由，再把需要用res.locals的中间件放在路由之后
  app.get('/product-detail', routes.views.productDetail, middleware.useProductLocals);
  
  // 其他路由...
  app.get('/', routes.views.index);
};

方案2：全局挂载中间件到路由之后 #

如果这个中间件需要全局生效，但依赖路由生成的res.locals变量，你可以把它放在所有路由挂载完成之后。Express会按挂载顺序执行中间件，这样所有路由处理完后，中间件才能拿到res.locals里的内容。

示例代码：

// index.js
exports = module.exports = function(app) {
  // 先挂载所有路由
  app.get('/', routes.views.index);
  app.get('/product-detail', routes.views.productDetail);
  
  // 再挂载依赖路由变量的全局中间件
  app.use(middleware.useRouteLocals);
};

⚠️ 注意：这种方式下中间件会在所有路由（包括404路由）之后执行，所以建议在中间件里先判断res.locals是否存在目标变量，避免报错。

方案3：抽离路由变量生成逻辑为前置中间件 #

如果productDetail路由里生成的变量需要被多个中间件或路由复用，建议把变量生成逻辑抽成独立的中间件，放在initLocals之后、路由之前执行。这样不管是路由还是后续中间件，都能直接拿到res.locals里的变量。

示例代码：

// middleware.js
exports.loadProductDetails = function(req, res, next) {
  // 这里写原来productDetail路由里生成变量的逻辑
  res.locals.product = await Product.findById(req.params.id).exec();
  next();
};

// index.js
keystone.pre('routes', middleware.initLocals);

exports = module.exports = function(app) {
  // 先执行变量生成中间件，再执行路由
  app.get('/product-detail', middleware.loadProductDetails, routes.views.productDetail);
  
  // 其他需要用到product变量的中间件或路由也能直接使用
};

关键提醒 #

不要用keystone.pre('routes')挂载需要依赖路由变量的中间件，这个钩子的设计就是在所有路由处理前执行，此时路由还没机会修改res.locals。Express的中间件执行顺序完全由挂载顺序决定，只要调整好顺序，就能解决你的问题。

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