2026-06-18 · Astro
打造真的能幫上忙的 Astro 錯誤頁
把預設的 404 與 500 畫面,改成能說明發生什麼事、下一步該怎麼做的頁面。
前言
自訂錯誤頁常常是專案的最後一件事。本文介紹 404.astro 與 500.astro 路由的寫法、記錄失敗請求的方式,以及在伺服器已經過載時如何讓錯誤頁維持輕量。
現場筆記
在處理 Astro 問題的過程中,反覆看到的幾個模式:
- 簡單的版本撐過了每次重構,聰明的版本沒有。
- 邊做邊寫的文件,比事後補寫的耐用得多。
- 同一個問題第二次出現時,它就已經是模式了——幫它命名吧。
可以直接抄的檢查清單
- 問題可以用一行指令重現。
- 修正附帶一個沒有它就會失敗的測試。
- 作者本人以外的人也在自己的機器上跑過。
結語
寫下未來的自己真的會讀的短版本——這就是全部的訣竅。