2025-01-28 · Express.js

在 Express 專案中一致地處理錯誤

一個錯誤類別、一個處理器、一種回應格式，外加包裝非同步函式避免未攔截的 Promise。

前言

打造一個精簡的錯誤處理層，涵蓋驗證、404 與非預期例外，且不必在每個 handler 裡寫 try/catch。

核心智模型

  • 從最小、能運作的版本開始，並讓它可觀測。
  • 把你正在承擔的取捨寫下來，而不只是寫下你交付了什麼功能。
  • 團隊規模改變時重新檢視決策；Express.js 的多數選擇都有保存期限。

實作起點

  1. 在實驗分支重現情境，並放在你信任的量測指標旁邊。
  2. 一次只改變一個變數，讓 diff 小到能用一句話解釋清楚。
  3. 保留成果、丟掉腳手架。
Terminal window
git switch -c experiment/one-thing

結語

這裡沒有教條。把它當成一份你有權不同意的檢查清單——最好附上你自己的實驗結果。