2026-06-18 · Astro
做一个真正能帮到用户的 Astro 错误页
把默认的 404 与 500 页面,改成能说明发生了什么、下一步该怎么做的页面。
前言
自定义错误页往往是项目里最后才做的事。本文介绍 404.astro 与 500.astro 路由的写法、记录失败请求的方式,以及在服务器已经过载时如何让错误页保持轻量。
现场笔记
在处理 Astro 问题的过程中,反复出现的几个模式:
- 简单的版本撑过了每次重构,聪明的版本没有。
- 边做边写的文档,比事后补写的耐用得多。
- 同一个问题第二次出现时,它就已经是一个模式了——给它起个名字。
可以直接抄的检查清单
- 问题可以用一条命令复现。
- 修复附带一个没有它就会失败的测试。
- 作者本人之外的人也在自己的机器上跑过。
写在最后
写下未来那个自己真正会读的短版本——这就是全部的诀窍。