Node.js Express：如何先检测404错误再执行认证中间件

问题场景 #

现有如下Express代码：

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

// Authentication middleware
app.use((req, res, next) => {
  // Simulate a DB check for authentication
  console.log('Checking authentication...');
  next();
});

// Route handlers
app.get('/example', (req, res) => {
  res.send('This is an example route.');
});

// 404 handler should be the last middleware
app.use((req, res, next) => {
  res.status(404).send('Route not found');
});

app.listen(3000, () => {
  console.log('Server is running on port 3000');
});

当前存在问题：访问不存在的页面时，系统仍会执行认证检查，希望能先判断路由是否存在，再决定是否执行认证逻辑。

解决方案 #

方案1：给指定路由单独绑定认证中间件

这是最直接且符合Express设计理念的方式，只给需要保护的路由添加认证中间件，未匹配的路由不会触发认证逻辑。

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

// 单独定义认证中间件
const authMiddleware = (req, res, next) => {
  console.log('Checking authentication...');
  next();
};

// 仅在需要认证的路由上使用中间件
app.get('/example', authMiddleware, (req, res) => {
  res.send('This is an example route.');
});

// 404 处理放在最后
app.use((req, res) => {
  res.status(404).send('Route not found');
});

app.listen(3000, () => {
  console.log('Server is running on port 3000');
});

方案2：使用路由组统一管理需要认证的路由

把所有需要认证的路由归到同一个路由实例中，给整个路由组添加认证中间件，未匹配到路由组的请求直接进入404处理。

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

// 创建路由实例
const protectedRouter = express.Router();

// 给路由组添加全局认证中间件
protectedRouter.use((req, res, next) => {
  console.log('Checking authentication...');
  next();
});

// 定义路由组内的路由
protectedRouter.get('/example', (req, res) => {
  res.send('This is an example route.');
});
// 可添加更多需要认证的路由...

// 挂载路由组到应用
app.use(protectedRouter);

// 404 处理放在最后
app.use((req, res) => {
  res.status(404).send('Route not found');
});

app.listen(3000, () => {
  console.log('Server is running on port 3000');
});

方案3：提前检测路由是否存在（不推荐生产环境）

通过遍历Express内部的路由栈，判断当前请求是否匹配已定义的路由，不匹配则直接返回404。这种方式依赖Express内部结构，版本变更可能导致失效，仅作参考。

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

// 先定义所有有效路由
const router = express.Router();
router.get('/example', (req, res) => {
  res.send('This is an example route.');
});

// 检查路由是否存在的中间件
const checkRouteExists = (req, res, next) => {
  let isRouteValid = false;
  // 遍历路由栈匹配请求方法和路径
  app._router.stack.forEach(layer => {
    if (layer.route) {
      const allowedMethods = Object.keys(layer.route.methods);
      const routePath = layer.route.path;
      if (allowedMethods.includes(req.method.toLowerCase()) && req.path === routePath) {
        isRouteValid = true;
      }
    }
  });

  if (!isRouteValid) {
    return res.status(404).send('Route not found');
  }
  next();
};

// 先检查路由有效性，再执行认证
app.use(checkRouteExists);

// Authentication middleware
app.use((req, res, next) => {
  console.log('Checking authentication...');
  next();
});

// 挂载有效路由
app.use(router);

// 兜底404处理
app.use((req, res) => {
  res.status(404).send('Route not found');
});

app.listen(3000, () => {
  console.log('Server is running on port 3000');
});

总结 #

优先选择方案1或方案2，这两种方式更符合Express的中间件设计逻辑，稳定性和可维护性更高。方案3仅作为特殊场景下的参考，不建议在生产环境使用。

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