2026-06-18 · Astro

做一个真正能帮到用户的 Astro 错误页

把默认的 404 与 500 页面,改成能说明发生了什么、下一步该怎么做的页面。

前言

自定义错误页往往是项目里最后才做的事。本文介绍 404.astro 与 500.astro 路由的写法、记录失败请求的方式,以及在服务器已经过载时如何让错误页保持轻量。

现场笔记

在处理 Astro 问题的过程中,反复出现的几个模式:

  • 简单的版本撑过了每次重构,聪明的版本没有。
  • 边做边写的文档,比事后补写的耐用得多。
  • 同一个问题第二次出现时,它就已经是一个模式了——给它起个名字。

可以直接抄的检查清单

  • 问题可以用一条命令复现。
  • 修复附带一个没有它就会失败的测试。
  • 作者本人之外的人也在自己的机器上跑过。

写在最后

写下未来那个自己真正会读的短版本——这就是全部的诀窍。