Express.js错误处理中间件被忽略：AuthError中间件未触发问题

核心问题原因 #

1. 错误传递方式错误
   第一个错误处理中间件在判断当前错误不是ValidationError时，调用了无参数的next()，而非next(error)。Express的规则是：只有调用next(error)才会将错误传递给下一个错误处理中间件；如果调用无参数的next()，会直接跳过后续所有错误处理中间件，转而执行普通路由/中间件（也就是你最后定义的404中间件）。

2. 404中间件位置与逻辑问题
   你的404中间件是普通中间件（没有接收error参数），本应放在所有路由和错误处理中间件的最后，但当前它在错误处理中间件之后，当错误被错误地用next()传递时，就会触发这个404中间件，而非后续的Auth错误处理逻辑。

修复方案 #

1. 修正错误处理中间件的错误传递逻辑 #

将两个错误处理中间件中的next()改为next(error)，确保错误能正常向下传递：

// 验证错误处理中间件
app.use((error: TypeError | ValidationError, req: Request, res: Response, next: NextFunction) => {
    console.log("CHECK FOR VALIDATION ERROR");
    if(error instanceof ValidationError) {
        console.log("VALIDATION ERROR FOUND")
        res.status(403).send(error);
    } else {
        console.log("NO VALIDATION ERROR");
        next(error); // 传递错误到下一个错误处理中间件
    }
});

// 认证错误处理中间件
app.use((error: TypeError | AuthError, req: Request, res: Response, next: NextFunction) => {
    console.log("CHECK FOR AUTH ERROR");
    if(error instanceof AuthError) {
        console.log("AUTH ERROR FOUND");
        res.status(403).send({msg: "Authentication failed"});
    } else {
        console.log("NO AUTH ERROR");
        next(error); // 传递错误到下一个错误处理中间件
    }
});

2. 调整404中间件的位置与逻辑 #

将404中间件移到所有路由和错误处理中间件的最末尾，并且移除不必要的next()调用（因为已经发送响应，无需继续传递）：

// 先定义所有路由
app.use("/app", authenticate);
// app.post("/new_user", validate({body: schema}), route_handler);
// more routes etc. 

// 然后定义所有错误处理中间件
// ... 上述修复后的验证、认证、通用错误处理中间件 ...

// 最后定义404中间件
app.use((req: Request, res: Response) => {
    console.log("ROUTE NOT FOUND");
    res.status(404).send({
        msg: "this endpoint was not found",
    });
});

补充说明 #

Express错误处理的核心规则：

• 错误处理中间件必须包含四个参数：(err, req, res, next)，缺少任何一个都会被视为普通中间件。
• 调用next(err)会触发错误处理流程，跳过所有普通中间件，直接匹配下一个错误处理中间件。
• 如果错误处理中间件中没有调用next(err)，错误传递会在此终止，后续错误处理中间件不会执行。

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