Express.js全局错误处理中间件异常输出问题求助

问题根源 #

你当前的代码中，全局错误处理中间件的注册顺序错误。Express要求错误处理中间件（带有err, req, res, next四个参数的中间件）必须放在所有路由、普通中间件以及404捕获路由之后，否则错误触发时无法进入自定义的错误处理逻辑，会返回Express默认的错误响应。

你的app.use(globalError)放在了路由和404处理之前，导致404错误触发时，这个中间件还未被Express加载，因此无法处理错误。

修复步骤 #

1. 调整中间件注册顺序，将全局错误处理中间件移到所有路由和404捕获路由之后
2. 确保错误处理中间件的参数完整（你的代码已经满足，此处做常规提醒）

修复后的完整代码 #

node/app.js #

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

// 普通中间件
app.use(express.json())

// 首页路由
app.get('/',(req,res)=>{
    res.send("homepage")
})

// 404路由捕获（必须在所有业务路由之后）
app.all('*',(req,res,next)=>{
    const err = new Error('route does not exist')
    err.statusCode = 404;
    next(err)
})

// 全局错误处理中间件（必须放在所有路由和其他中间件之后）
const globalError = require('./middleware/globalErrorHandlingMiddleware')
app.use(globalError)

// 启动服务
app.listen(3000,()=>{
    console.log('server started at port 3000')
})

node/middleware/globalErrorHandlingMiddleware.js（无需修改，若需返回状态码可补充字段） #

function globalErrorHandler(err, req, res, next){
    
    const errorMessage = err.message || 'Something went wrong.';
    const statusCode = err.statusCode || 500;

    res.status(statusCode).json({
        error: errorMessage,
        statusCode: statusCode // 若需要在响应中包含状态码，添加此行
    });
};

module.exports = globalErrorHandler

验证效果 #

启动服务后访问不存在的路由（比如GET /test），会返回符合预期的JSON响应：

{
  "error": "route does not exist",
  "statusCode": 404
}

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