为什么我的Express错误处理中间件无法正常捕获抛出的错误

问题根因 #

Express v4 版本的错误处理中间件默认仅能捕获同步代码抛出的异常。你在路由中使用了 async 异步处理函数，函数内抛出的错误会转化为 Promise 拒绝状态，没有被主动传递给 next 函数，因此全局错误处理中间件无法捕获该错误，最终触发未处理Promise拒绝警告。

解决方案 #

方案1：手动捕获错误传递给next #

修改 router.ts 中的路由代码，新增try/catch块捕获异步错误，主动调用next(err)将错误传给全局中间件：

import express from 'express'
import { NotFoundError } from './errors/not-found';
import { NextFunction, Request, Response } from "express";
const router = express.Router()
router.all('/*', async (req: Request, res: Response, next: NextFunction) => {
    try {
        throw new NotFoundError()
    } catch (err) {
        next(err)
    }
})
export default router

方案2：封装通用异步处理高阶函数 #

如果项目中async路由较多，可以封装一个统一的错误捕获 wrapper，避免每个路由重复写try/catch：

// 可放在公共工具文件中
import { NextFunction, Request, Response } from "express";
export const asyncHandler = (fn: (req: Request, res: Response, next: NextFunction) => Promise<any>) => {
  return (req: Request, res: Response, next: NextFunction) => {
    fn(req, res, next).catch(next)
  }
}

路由中直接使用包装器即可：

router.all('/*', asyncHandler(async (req, res) => {
    throw new NotFoundError()
}))

方案3：升级到Express v5 #

Express v5 版本原生支持异步路由错误自动捕获，async函数内抛出的错误会自动传递给错误处理中间件，无需额外添加捕获逻辑，直接使用原有代码即可生效。

修改完成后访问不存在的路径，即可正常返回404状态码和{"errors":[{"message":"Not found"}]}的序列化响应，不会再触发未处理Promise拒绝警告。

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