解决前端页面刷新后的 404

理解单页面应用回退的用途,防止接口和缺失资源错误返回 HTML。

🎯 引言

有的网站点击菜单能进入 /notes/1,刷新却得到 404。这通常是浏览器内的页面切换与服务器的文件查找发生了错位。本篇只解决这种刷新问题。


🧱 为什么点击和刷新结果不同

**单页面应用(SPA)**通常先加载一份 index.html,再由浏览器中的 JavaScript 根据路径决定显示哪一页。用户点击菜单时,前端程序可以修改地址和画面,而不重新请求整份 HTML;这种“路径对应哪个画面”的规则叫前端路由。

刷新时浏览器直接请求 /notes/1。Nginx 不知道前端路由规则,只会到磁盘找 html/notes/1。文件不存在,原有 try_files 就返回 404。

解决思路是:对于页面路径,先找真实文件;找不到时发送 index.html,由前端决定显示什么。


🛠 只让页面路径回退

将 site.conf 原有的 location / 替换,并新增资源规则:

location ^~ /assets/ {
    try_files $uri =404;
}

location = /index.html {
    add_header Cache-Control 'no-cache';
}

location / {
    try_files $uri $uri/ /index.html;
}

最后的 /index.html 不是错误码,而是内部转向的路径;地址栏不变。精确匹配的首页块还能避免入口不存在时反复回退。Cache-Control 是发给浏览器的缓存要求,下一篇解释 no-cache。

/assets/ 要单独处理,因为不存在的 JavaScript 或 CSS 应该返回 404。如果它们被替换成 HTML,浏览器可能报“脚本语法错误”或内容类型错误,排查会更困难。

未来的 /api/ 会交给反向代理,它也不应回退到首页。若图片、字体放在 /images/ 或 /fonts/,给这些目录增加同样的独立文件规则。


🧪 观察服务器做了什么

检查并重载后执行:

curl -i http://127.0.0.1:8080/notes/1
curl -i http://127.0.0.1:8080/assets/missing.js

第一条应返回 200 和首页 HTML,第二条应为 404。当前实验首页没有前端路由程序,因此浏览器打开 /notes/1 仍显示相同的“我的学习笔记”,这证明回退生效,并不代表已经实现笔记详情页。

如果你以后用前端构建工具生成网站,应将构建产物放进公开目录;Nginx 负责文件发送,前端代码负责页面切换。需要服务器在每次访问时生成 HTML 的应用,则应按代理章节转发到应用程序,不能统一套用静态回退。


❓ 知识问答

Q1:配置回退后,不存在的页面也返回 200,正常吗?

这是本例回退的结果。实际页面是否存在由前端判断;如果需要服务器提供准确的页面 404 状态,应采用相应的服务端生成方案。

Q2:能不能用 error_page 404 /index.html 给整个站点兜底?

不建议这样入门。它容易把文件、接口等不该回退的错误混在一起,先明确区分页面路径与资源路径。


🧪 小练习

把 site.css 临时改名,访问 /assets/site.css,再访问 /notes/2,最后恢复文件名。

验收:样式文件缺失返回 404,页面路径仍返回首页 HTML。能够解释为什么两类地址需要不同规则。文件回退行为可查try_files 官方说明。


🎉 页面刷新和资源缺失现在有了各自明确的处理方式!