Express接口返回状态码异常问题求助

问题现象 #

当用户不存在时，认证服务抛出user does not exist错误，handleLogin中的catch块确实触发（打印了Here-3），但HTTP响应状态码为200 OK，而非代码中指定的500（INTERNAL_SERVER_ERROR），仅响应JSON中的message字段正确显示错误信息。

核心错误原因分析 #

1. 全局错误处理中间件位置错误 #

Express的中间件按注册顺序执行，错误处理中间件必须放在所有路由和其他中间件之后，否则无法捕获路由处理过程中抛出的未处理错误。你当前将错误中间件注册在路由之前，导致它不会参与后续路由的错误捕获流程。

2. 局部catch块响应状态码异常验证点 #

你提到已确认INTERNAL_SERVER_ERROR枚举值为500，但仍出现状态码为OK的情况，可排查以下几点：

• 检查测试工具是否误将响应体中的status字段当作HTTP状态码显示；
• 在catch块中新增console.log(HttpStatusCode.INTERNAL_SERVER_ERROR)，验证枚举值是否确实为500；
• 排查是否存在其他中间件篡改了响应状态码。

修复方案 #

步骤1：调整全局错误处理中间件位置 #

将错误处理中间件移动到所有路由注册之后，确保它能捕获所有路由的未处理错误：

// 先注册所有路由
app.use(`/api/v1/auth`, authRouter)
app.use(`/api/v1/users`, usersRouter);
app.use("/api/v1/journals", journalsRouter)
app.use(`/api/v1/groups`, groupsRouter)

// 再注册全局错误处理中间件
app.use((err: Error, req: Request, res: Response, next: NextFunction) => {
  console.error(err.stack);
  res.status(500).json({
    message: 'Internal Server Error',
    status: 500
  });
});

步骤2：优化局部错误处理（可选） #

用户不存在属于业务逻辑错误，返回404或401更符合REST规范，同时确保catch块响应逻辑正确：

const handleLogin = async (req: Request, res: Response<AuthResponse>) => {
  try {
    // ... 原有代码
  } catch (err: any) {
    console.log("Here-3", HttpStatusCode.INTERNAL_SERVER_ERROR); // 新增日志验证状态码数值
    // 根据错误类型返回对应状态码
    if (err.message === "user does not exist") {
      return res.status(HttpStatusCode.NOT_FOUND).json({
        message: err.message,
        status: HttpStatusCode.NOT_FOUND
      });
    }
    return res.status(HttpStatusCode.INTERNAL_SERVER_ERROR).json({
      message: err.message,
      status: HttpStatusCode.INTERNAL_SERVER_ERROR
    });
  }
}

步骤3：简化认证服务错误处理 #

认证服务中的try/catch属于冗余包裹，直接抛出错误即可：

const authenticate = async (credentials: UserAuthenticationBody): Promise<boolean> => {
  const user: UserDocument | null = await User.findOne({
    $or: [
      { username: credentials.username },
      { email: credentials.username }
    ]
  });

  if (!user) {
    throw new Error("user does not exist");
  }

  const passwordMatch = await bcrypt.compare(credentials.password, user.password);
  return passwordMatch;
}

验证方法 #

1. 重启服务后，测试用户不存在的登录请求；
2. 使用浏览器开发者工具或Postman查看HTTP响应状态码，确认是否为预期值；
3. 检查控制台日志，确认Here-3后打印的状态码数值是否为500。

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