首页没问题,点进去也正常,一刷新 /settings 却变成 404。遇到这种现象,先记住出错的是哪个地址。页面路由找不到和 JavaScript 文件找不到,虽然都可能显示 404,处理方法并不一样。
先确认放进去的是构建结果
如果项目需要构建,先按项目自己的说明完成构建,再检查输出目录里是否有入口 HTML 和引用的资源。Devio 创建静态站点时应选择实际需要提供给浏览器的目录,而不是凭名字猜一个 dist。
用浏览器打开首页,查看开发者工具的网络面板。页面空白时,先找失败的 JS、CSS 请求:请求地址、状态码和响应内容,比空白页面本身更能说明问题。
只有前端路由需要回退
单页应用可能由浏览器里的路由器处理 /settings 这类地址。站内点击时没有重新请求整页;刷新后,服务器会收到这个路径,如果没有对应文件,就可能返回 404。
Devio 的静态站点支持 SPA 路由回退。确认项目使用这种路由方式后,在静态站点的相关配置中启用对应功能;入口名称以当前应用为准。普通多页网站缺少一个 HTML 文件时,应补齐文件或修正链接,不要靠回退把所有错误都遮住。
按这个顺序复查
- 直接访问首页,确认入口文件能加载。
- 从首页点击进入一个实际存在的前端页面。
- 在这个子页面刷新,再把同一地址复制到新标签页打开。
- 检查网络面板里的 JS、CSS 和图片请求是否仍然成功。
如果页面请求成功了,脚本却报语法错误,打开脚本请求的响应看一眼:它可能拿到了 HTML。路由回退不应该被当成修复资源路径的通用办法。按项目文档检查构建时的资源基础路径,并重新构建。
API 的 404 单独看
前端页面恢复,不代表后端接口也已经接通。接口地址、代理目标和后端路由仍需分别核对。尤其不要看到所有请求都返回 200 就认定成功:本来需要 JSON 的接口,如果返回首页 HTML,应用照样不能正常工作。
改配置前保留原值。确认是哪一层出错后再动手,比同时改多个选项更容易看出效果。
发表回复