解决前端页面刷新后的 404
🎯 引言
有的网站点击菜单能进入 /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 官方说明。
🎉 页面刷新和资源缺失现在有了各自明确的处理方式!
