← 返回博客

静态站点首页能打开,刷新子页面却 404,先查这几处


首页没问题,点进去也正常,一刷新 /settings 却变成 404。遇到这种现象,先记住出错的是哪个地址。页面路由找不到和 JavaScript 文件找不到,虽然都可能显示 404,处理方法并不一样。

先确认放进去的是构建结果

如果项目需要构建,先按项目自己的说明完成构建,再检查输出目录里是否有入口 HTML 和引用的资源。Devio 创建静态站点时应选择实际需要提供给浏览器的目录,而不是凭名字猜一个 dist。

用浏览器打开首页,查看开发者工具的网络面板。页面空白时,先找失败的 JS、CSS 请求:请求地址、状态码和响应内容,比空白页面本身更能说明问题。

只有前端路由需要回退

单页应用可能由浏览器里的路由器处理 /settings 这类地址。站内点击时没有重新请求整页;刷新后,服务器会收到这个路径,如果没有对应文件,就可能返回 404。

Devio 的静态站点支持 SPA 路由回退。确认项目使用这种路由方式后,在静态站点的相关配置中启用对应功能;入口名称以当前应用为准。普通多页网站缺少一个 HTML 文件时,应补齐文件或修正链接,不要靠回退把所有错误都遮住。

按这个顺序复查

  1. 直接访问首页,确认入口文件能加载。
  2. 从首页点击进入一个实际存在的前端页面。
  3. 在这个子页面刷新,再把同一地址复制到新标签页打开。
  4. 检查网络面板里的 JS、CSS 和图片请求是否仍然成功。

如果页面请求成功了,脚本却报语法错误,打开脚本请求的响应看一眼:它可能拿到了 HTML。路由回退不应该被当成修复资源路径的通用办法。按项目文档检查构建时的资源基础路径,并重新构建。

API 的 404 单独看

前端页面恢复,不代表后端接口也已经接通。接口地址、代理目标和后端路由仍需分别核对。尤其不要看到所有请求都返回 200 就认定成功:本来需要 JSON 的接口,如果返回首页 HTML,应用照样不能正常工作。

改配置前保留原值。确认是哪一层出错后再动手,比同时改多个选项更容易看出效果。


发表回复

您的邮箱地址不会被公开。 必填项已用 * 标注