摘要：捕捉錯(cuò)誤確保捕獲運(yùn)行路由處理程序和中間件時(shí)發(fā)生的所有錯(cuò)誤非常重要。對(duì)和的調(diào)用表明當(dāng)前處理程序已完成并處于什么狀態(tài)，將跳過(guò)鏈中的所有剩余處理程序，除了那些設(shè)置為處理上述錯(cuò)誤的處理程序。

錯(cuò)誤處理是指Express如何捕獲和處理同步和異步發(fā)生的錯(cuò)誤，Express附帶一個(gè)默認(rèn)的錯(cuò)誤處理程序，因此你無(wú)需編寫(xiě)自己的錯(cuò)誤處理程序即可開(kāi)始使用。

確保Express捕獲運(yùn)行路由處理程序和中間件時(shí)發(fā)生的所有錯(cuò)誤非常重要。

路由處理程序和中間件內(nèi)的同步代碼中發(fā)生的錯(cuò)誤不需要額外的工作，如果同步代碼拋出錯(cuò)誤，則Express將捕獲并處理它，例如：

app.get("/", function (req, res) {
  throw new Error("BROKEN"); // Express will catch this on its own.
});

對(duì)于由路由處理程序和中間件調(diào)用的異步函數(shù)返回的錯(cuò)誤，必須將它們傳遞給next()函數(shù)，Express將捕獲并處理它們，例如：

app.get("/", function (req, res, next) {
  fs.readFile("/file-does-not-exist", function (err, data) {
    if (err) {
      next(err); // Pass errors to Express.
    }
    else {
      res.send(data);
    }
  });
});

如果將任何內(nèi)容傳遞給next()函數(shù)（字符串"route"除外），則Express將當(dāng)前請(qǐng)求視為錯(cuò)誤，并將跳過(guò)任何剩余的非錯(cuò)誤處理路由和中間件函數(shù)。

如果序列中的回調(diào)不提供數(shù)據(jù)，只提供錯(cuò)誤，則可以按如下方式簡(jiǎn)化此代碼：

app.get("/", [
  function (req, res, next) {
    fs.writeFile("/inaccessible-path", "data", next);
  },
  function (req, res) {
    res.send("OK");
  }
]);

在上面的示例中，next作為fs.writeFile的回調(diào)提供，調(diào)用時(shí)有或沒(méi)有錯(cuò)誤，如果沒(méi)有錯(cuò)誤，則執(zhí)行第二個(gè)處理程序，否則Express會(huì)捕獲并處理錯(cuò)誤。

你必須捕獲由路由處理程序或中間件調(diào)用的異步代碼中發(fā)生的錯(cuò)誤，并將它們傳遞給Express進(jìn)行處理，例如：

app.get("/", function (req, res, next) {

  setTimeout(function () {
    try {
      throw new Error("BROKEN");
    }
    catch (err) {
      next(err);
    }
  }, 100);
});

上面的示例使用try...catch塊來(lái)捕獲異步代碼中的錯(cuò)誤并將它們傳遞給Express，如果省略try...catch塊，Express將不會(huì)捕獲錯(cuò)誤，因?yàn)樗皇峭教幚沓绦虼a的一部分。

使用promises可以避免try...catch塊的開(kāi)銷或者使用返回promises的函數(shù)，例如：

app.get("/", function (req, res, next) {
  Promise.resolve().then(function () {
    throw new Error("BROKEN");
  }).catch(next); // Errors will be passed to Express.
});

由于promises會(huì)自動(dòng)捕獲同步錯(cuò)誤和拒絕promises，你可以簡(jiǎn)單地提供next作為最終的catch處理程序，Express將捕獲錯(cuò)誤，因?yàn)?b>catch處理程序被賦予錯(cuò)誤作為第一個(gè)參數(shù)。

你還可以使用處理程序鏈來(lái)依賴同步錯(cuò)誤捕獲，通過(guò)將異步代碼減少為一些簡(jiǎn)單的代碼，例如：

app.get("/", [
  function (req, res, next) {
    fs.readFile("/maybe-valid-file", "utf8", function (err, data) {
        res.locals.data = data;
        next(err);
    });
  },
  function (req, res) {
    res.locals.data = res.locals.data.split(",")[1];
    res.send(res.locals.data);
  }
]);

上面的例子有一些來(lái)自readFile調(diào)用的簡(jiǎn)單語(yǔ)句，如果readFile導(dǎo)致錯(cuò)誤，那么它將錯(cuò)誤傳遞給Express，否則你將快速返回到鏈中下一個(gè)處理程序中的同步錯(cuò)誤處理的世界。然后，上面的示例嘗試處理數(shù)據(jù)，如果失敗，則同步錯(cuò)誤處理程序?qū)⒉东@它，如果你在readFile回調(diào)中完成了此處理，則應(yīng)用程序可能會(huì)退出，并且Express錯(cuò)誤處理程序?qū)o(wú)法運(yùn)行。

無(wú)論使用哪種方法，如果要調(diào)用Express錯(cuò)誤處理程序并使應(yīng)用程序存活，你必須確保Express收到錯(cuò)誤。

Express附帶了一個(gè)內(nèi)置的錯(cuò)誤處理程序，可以處理應(yīng)用程序中可能遇到的任何錯(cuò)誤，此默認(rèn)錯(cuò)誤處理中間件函數(shù)添加在中間件函數(shù)堆棧的末尾。

如果你將錯(cuò)誤傳遞給next()并且你沒(méi)有在自定義錯(cuò)誤處理程序中處理它，它將由內(nèi)置錯(cuò)誤處理程序處理，錯(cuò)誤將堆棧跟蹤寫(xiě)入客戶端，堆棧跟蹤不包含在生產(chǎn)環(huán)境中。

將環(huán)境變量NODE_ENV設(shè)置為production，以在生產(chǎn)模式下運(yùn)行應(yīng)用程序。

如果在開(kāi)始寫(xiě)入響應(yīng)后調(diào)用next()并出現(xiàn)錯(cuò)誤（例如，如果在將響應(yīng)流式傳輸?shù)娇蛻舳藭r(shí)遇到錯(cuò)誤），則Express默認(rèn)錯(cuò)誤處理程序?qū)㈥P(guān)閉連接并使請(qǐng)求失敗。

因此，當(dāng)你添加自定義錯(cuò)誤處理程序時(shí)，必須在headers已發(fā)送到客戶端時(shí)委托給默認(rèn)的Express錯(cuò)誤處理程序：

function errorHandler (err, req, res, next) {
  if (res.headersSent) {
    return next(err)
  }
  res.status(500)
  res.render("error", { error: err })
}

請(qǐng)注意，如果你在你的代碼調(diào)用next()出現(xiàn)錯(cuò)誤多次，則會(huì)觸發(fā)默認(rèn)錯(cuò)誤處理程序，即使自定義錯(cuò)誤處理中間件已就緒也是如此。

以與其他中間件函數(shù)相同的方式定義錯(cuò)誤處理中間件函數(shù)，除了錯(cuò)誤處理函數(shù)有四個(gè)參數(shù)而不是三個(gè)：(err, req, res, next)，例如：

app.use(function (err, req, res, next) {
  console.error(err.stack)
  res.status(500).send("Something broke!")
})

你可以在其他app.use()和路由調(diào)用之后定義錯(cuò)誤處理中間件，例如：

var bodyParser = require("body-parser")
var methodOverride = require("method-override")

app.use(bodyParser.urlencoded({
  extended: true
}))
app.use(bodyParser.json())
app.use(methodOverride())
app.use(function (err, req, res, next) {
  // logic
})

中間件函數(shù)內(nèi)的響應(yīng)可以是任何格式，例如HTML錯(cuò)誤頁(yè)面、簡(jiǎn)單消息或JSON字符串。

對(duì)于組織（和更高級(jí)別的框架）目的，你可以定義多個(gè)錯(cuò)誤處理中間件函數(shù)，就像使用常規(guī)中間件函數(shù)一樣，例如，為使用XHR和不使用XHR的請(qǐng)求定義錯(cuò)誤處理程序：

var bodyParser = require("body-parser")
var methodOverride = require("method-override")

app.use(bodyParser.urlencoded({
  extended: true
}))
app.use(bodyParser.json())
app.use(methodOverride())
app.use(logErrors)
app.use(clientErrorHandler)
app.use(errorHandler)

在此示例中，通用logErrors可能會(huì)將請(qǐng)求和錯(cuò)誤信息寫(xiě)入stderr，例如：

function logErrors (err, req, res, next) {
  console.error(err.stack)
  next(err)
}

同樣在此示例中，clientErrorHandler定義如下，在這種情況下，錯(cuò)誤會(huì)明確傳遞給下一個(gè)錯(cuò)誤。

請(qǐng)注意，在錯(cuò)誤處理函數(shù)中不調(diào)用“next”時(shí)，你負(fù)責(zé)編寫(xiě)（和結(jié)束）響應(yīng)，否則這些請(qǐng)求將“掛起”，并且不符合垃圾回收的條件。

function clientErrorHandler (err, req, res, next) {
  if (req.xhr) {
    res.status(500).send({ error: "Something failed!" })
  } else {
    next(err)
  }
}

實(shí)現(xiàn)“catch-all”的errorHandler函數(shù)，如下所示（例如）：

function errorHandler (err, req, res, next) {
  res.status(500)
  res.render("error", { error: err })
}

如果你有一個(gè)具有多個(gè)回調(diào)函數(shù)的路由處理程序，則可以使用route參數(shù)跳轉(zhuǎn)到下一個(gè)路由處理程序，例如：

app.get("/a_route_behind_paywall",
  function checkIfPaidSubscriber (req, res, next) {
    if (!req.user.hasPaid) {
      // continue handling this request
      next("route")
    }
    else{
      next();
    }
  }, function getPaidContent (req, res, next) {
    PaidContent.find(function (err, doc) {
      if (err) return next(err)
      res.json(doc)
    })
  })

在此示例中，將跳過(guò)getPaidContent處理程序，但app中的/a_route_behind_paywall中的任何剩余處理程序?qū)⒗^續(xù)執(zhí)行。

對(duì)next()和next(err)的調(diào)用表明當(dāng)前處理程序已完成并處于什么狀態(tài)，next(err)將跳過(guò)鏈中的所有剩余處理程序，除了那些設(shè)置為處理上述錯(cuò)誤的處理程序。