404 资源未找到
快速摘要
浏览器请求的 URL 在服务器上不存在——可能是路径写错、文件被删，或路由配置有误。
为什么发生
URL 路径拼写错误，或大小写不匹配
页面/文件被移动或删除，但链接没有更新
静态站点的路由配置没有为该路径生成页面
开发环境与生产环境的路径前缀不一致（如 base URL）
最小示例
✗ 错误代码
<a href="/about-us">关于我们</a>✓ 修复代码
<a href="/about">关于我们</a>实际页面是 /about，但链接写成了 /about-us，访问就 404。改成正确路径即可。
如何诊断
查看浏览器地址栏或 Network 面板中的完整 URL
在服务器或构建产物中确认该路径对应的文件是否存在
检查路由配置（如 Astro 的
src/pages/）是否覆盖了该路径
如何修复
修正链接的 URL，与实际路径一致
重新部署被误删的文件，或更新所有指向它的链接
为静态站点配置统一的 base URL 前缀
如何预防
使用构建工具自动生成内部链接，避免手写 URL
部署后用死链检测工具（如 linkinator）扫描全站