REST API中间件失败响应及Express currentUser中间件错误捕获方案

1. REST API中间件执行失败的响应情况 #

• 若中间件执行失败时调用 next(err) 传递错误对象，Express会触发全局错误处理中间件，通常返回5xx系列状态码（如500 Internal Server Error），响应内容由错误处理逻辑决定，一般包含错误描述。
• 若中间件直接通过 res.status(code).send(content) 返回响应，则会按指定的状态码和内容返回，比如身份验证失败时返回401 Unauthorized。
• 若中间件吞掉错误（如空catch块）且未传递错误，请求会继续执行后续中间件或路由，但可能导致响应不符合预期，比如身份信息缺失却返回200状态码。

2. 给定Express代码的分析与处理方案 #

中间件解析失败时的请求执行逻辑 #

从给出的currentUser中间件代码来看：

• 当JWT解析失败时，catch块为空，不会给req.currentUser赋值，随后直接调用next()，请求会正常进入后续路由处理函数。
• 路由处理函数中req.currentUser || null的判断会让currentUser取值为null，最终响应内容为 { currentUser: null }，状态码默认是200 OK。

不修改中间件时，捕获错误的路由修改方案 #

原中间件吞掉了解析错误，没有传递错误信息，因此需要在路由处理函数中重新验证JWT来捕获失败情况：

import jwt from 'jsonwebtoken';
import { Request, Response } from 'express';

router.get("/api/users/currentuser", currentUser, (req: Request, res: Response) => {
  let tokenError = null;
  if (req.session?.jwt) {
    try {
      jwt.verify(req.session.jwt, process.env.JWT_KEY!);
    } catch (err) {
      tokenError = err;
    }
  }

  if (tokenError) {
    return res.status(401).send({ 
      currentUser: null, 
      error: "无效或已过期的认证令牌" 
    });
  }

  res.send({ currentUser: req.currentUser || null });
});

这样就能在不改动原中间件的前提下，捕获JWT解析错误并返回明确的错误响应。

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