TypeScript编写的Node.js Express项目自定义错误响应不生效如何解决？

核心问题1：错误处理中间件签名不符合Express规范 #

Express 强制要求错误处理中间件必须声明4个参数，顺序为(err, req, res, next)，即使你在逻辑中不需要使用next参数也必须显式声明。缺少第四个参数时，Express会将其识别为普通中间件，不会触发错误处理逻辑。
你当前的handleError函数只有3个参数，因此不符合要求：

// 错误写法：缺少next参数
const handleError = (err: any, req: Request, res: Response) => {
  // 逻辑代码
}

修复后写法：

// 正确写法：声明4个参数，Express才会识别为错误处理中间件
import { NextFunction } from 'express'

const handleError = (err: any, req: Request, res: Response, next: NextFunction) => {
  res.status(err.statusCode || 500).json({
    success: false,
    error: err.message || 'Internal Server Error',
  });
};

核心问题2：导入导出不匹配 #

你在useErrorHandler.ts中通过export default handleError默认导出错误处理函数，如果./middlewares目录下的聚合导出文件（index.ts）没有做额外的重命名导出处理，在app.ts中使用命名导入import { useErrorHandler } from './middlewares'会拿到undefined，相当于没有注册错误处理中间件。
两种修复方式二选一：

• 方式1：调整导出规则，改为命名导出

// useErrorHandler.ts 修改导出方式
export const handleError = (err: any, req: Request, res: Response, next: NextFunction) => {
  // 逻辑代码
}

然后在middlewares/index.ts中统一导出：

export * from './useErrorHandler'

• 方式2：调整导入规则，使用默认导入

// app.ts 直接导入对应文件
import useErrorHandler from './middlewares/useErrorHandler'

可选优化：补充async控制器错误捕获 #

如果后续你的控制器中不是显式调用next(err)，而是直接在async函数中抛出错误，需要给路由层加一层async错误捕获包装，否则错误依然会直接抛到控制台：

// 通用async错误捕获中间件
import { NextFunction, Request, Response } from 'express'

export const asyncHandler = (fn: Function) => (req: Request, res: Response, next: NextFunction) => {
  Promise.resolve(fn(req, res, next)).catch(next)
}

// 路由中使用
router.post('/', asyncHandler(handleCreateCategory))

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