前言

在使用 Express 开发 API 时最常见的痛点之一就是中间件执行顺序与错误处理机制的混乱感。许多开发者遇到：

• 看不清全局中间件和路由级中间件的先后关系。怎么说呢，
• 错误被忽略或被错误捕获后继续往下执行。导致调试困难，
• 一次性调用多次 next 导致意外跳转或崩溃。
• Promise 或异步函数中的错误如何传递给后续中间件不直观。老实说，

这里通过代码实例和原理分析。帮助你理清这些痛点，并给出一种可复现的实现思路。

Express 中间件基本使用

正常运行时的执行顺序

import express from 'express';const app = express;// 全局中间件
app.use => {
console.log;next，});// 局部中间件
app.get('/news',=> {
console.log;next，},=> {
console.log;next，},=> {
console.log;next，}
);// 全局中间件
app.use(
// 全局错误处理
=> {
console.log;next，},// 普通全局
=> {
console.log;next，}
);// 再一次相同路由的其他层级
app.get('/news',=> {
console.log;next，话说回来，},=> {
console.log;next，}
);app.listen => { console.log;})，

输出结果：

• `use1---全局中间件1`
• `news1---局部中间件1`
• `news1---局部中连锁面板...`
• `use2---全局...` 等 …

**正常运行不会触发任何错误处理中间件**，即使它们已定义在链条上。

抛错后的行为

本地路由级别捕获异常

// 在某个路由层抛错
app.get('/error',=>{
console.log;// throw new Error;// 或者直接 throw 错误
return Promise.reject);},// 正常层会被跳过直到找到第一个错误处理中间件
=>{
console.log;res.status.send;} )，

alert：

• "next" 必须只调用一次否则会产生不可预料的行为。
• "throw" 和 "next" 的区别：前者同步抛错，后者显式将错误传递给下一个处理器。
• "Promise.reject" 会被包装成异步异常，一样会跳转到最近的错误处理中间器。

跨域捕获差异示例

app.use=>{console.log;next，});说起来，app.get=>{console.log;next，});// 此处没有对应 err-handler；老实说，但我们仍然可以通过 global error 捕获：
app.use;res.status.send}));

• *如果异常在同一路由级别内没有对应 err-handler。Express 将向上寻找最近一次注册的 err-handler，无论它是 global 或 local。*
• *所以。要确保至少有一个 global error handler，否则会直接返回默认服务器报错页面。*

初始化阶段运行时优先级规则

/* 当请求触发第一个正常 middleware 时如果之前已经存在 err-handler。* Express 会跳过它们，只执行第一个匹配到的普通 middleware */
app.use{ /* global error */});按理说，app.get=>{ await Promise.reject;})，app.use=>{ /* anor normal */});

User Pain Point Highlight: 很多人因误把 `await Promise.reject` 放在普通 middleware 中。 而导致整个链条提前终止，却又不明白为什么后面的 normal middleware 能够继续执行。其实是因为 `await` 抛出的异步异常会自动进入下一个符合条件的 error handler；若无，则继续寻找更高层次。理解这一点能减少“看似无效”的日志输出。按理说，​

• **`next` 的多次调用**：只能第一次有效。第二次及以后会直接导致 “Cannot set headers after y are sent” 或 “next called multiple times”。建议统一使用 Promise 链式或 async/await 来控制流。​​
• **参数类型判断**：Express 数为四个，即 `` 则视为 error handler。务必保持一致，否则可能出现无法捕捉到预期的 err‑handler 的情况。​
• **Promise 包装**：对于 async 函数，任何未处理拒绝都会被 Express 自动捕获并交给最近一次注册的 err‑handler。但如果你手动写了 `.catch` 并返回 `null` 或 `undefined`。则可能失去默认行为，请注意不要手动吞掉异常。​
• **作用域区分**：当你在同一文件里混用 `router.use` 与 `router.get` 时要记得它们分别属于不同作用域，全量搜索时请按需判断是否应该走相同域还是全域逻辑。​

Aim: 重现上述行为。但使用自定义链表结构来管理 middlewares，让你更直观地看到每一步。<\/blockquote>

class MiddlewareChain{
constructor{
this.head = null;this.tail = null;this.globalScope = Symbol;}
_wrap{
const node={fn。isErr,scope:null};if{this.head=this.tail=node;}
else {this.tail.next=node;node.prev=this.tail;this.tail=node;}
return node;}
use{ fns.forEach);}
add{ fns.forEach);} /* 同 use */
/* 注册 error handler */
handleError{ fns.forEach);}
run{
let current=this.head;const callNext==>current && this._exec;const execNode=async=>{
try{
if{
await node.fn=>{e?callNext:node.next&&node.next.exec});怎么说呢，}else{
await node.fn=>e?node.next && node.next.exec:node.next && node.next.exec);}
}catch{ /* 未处理则传播至下一 err‑handler */}
current=node.next;if

⚠️ 注意事项：

• 'isErr' 判断依据是 fn.length===4；如果你写的是 `` 而非 `` 则需手动标记为 isErr。

const chain = new MiddlewareChain;chain.add(
async=>{
console.log;await Promise.resolve;// 正常结束
},async=>{
console.log;throw new Error;// 抛错进入下一个 err‑handler
});chain.handleError(
async=>{
console.log;n，// 可选继续向下走
});chain.run，// 模拟请求/响应对象
// 输出预期:
// normal A
// normal B - will throw
// caught by local err boom
<\/code>

如有疑问、bug 指正或进一步探讨。欢迎留言或私信，我将及时更新说明，谢谢！​​​​​​​