2026-06-18 · Astro

打造真的能幫上忙的 Astro 錯誤頁

把預設的 404 與 500 畫面,改成能說明發生什麼事、下一步該怎麼做的頁面。

前言

自訂錯誤頁常常是專案的最後一件事。本文介紹 404.astro 與 500.astro 路由的寫法、記錄失敗請求的方式,以及在伺服器已經過載時如何讓錯誤頁維持輕量。

現場筆記

在處理 Astro 問題的過程中,反覆看到的幾個模式:

  • 簡單的版本撐過了每次重構,聰明的版本沒有。
  • 邊做邊寫的文件,比事後補寫的耐用得多。
  • 同一個問題第二次出現時,它就已經是模式了——幫它命名吧。

可以直接抄的檢查清單

  • 問題可以用一行指令重現。
  • 修正附帶一個沒有它就會失敗的測試。
  • 作者本人以外的人也在自己的機器上跑過。

結語

寫下未來的自己真的會讀的短版本——這就是全部的訣竅。