Web 服务器与网关 / 系统课时
try_files 为什么常用于前端应用
try_files 为什么常用于前端应用
单页应用内部跳到 /orders/42 可以正常显示,浏览器刷新后却可能得到 404,因为服务器开始按该路径寻找文件。本篇配置首页回退,同时让缺失静态资源和 API 仍然报错,避免所有请求都被伪装成成功的 HTML。
学习目标
- 解释前端路由与服务器文件路径的差异。
- 用 try_files 为页面路径回退到 HTML 入口。
- 将静态资源、API 和入口缺失的失败行为单独验证。
页面路由不一定有同名文件
History 路由的 /orders/42 常由浏览器里的路由器解释,发布目录里可能只有 index.html、脚本与样式。刷新时服务器收到新的 HTTP 请求,若只做普通静态查找,就会寻找磁盘上的 /orders/42,找不到便返回 404。
try_files 可以依次探测文件和目录,最后一项作为错误码或内部跳转目的地。在本例中,页面路径找不到文件时转向 /index.html,让浏览器拿到入口后再由真实前端路由器解释地址;它不会替你实现订单页面或后端接口。
给不同请求安排不同兜底
准备 /srv/spa-demo/index.html,内容为 spa-entry 并带换行,目录下没有 orders、assets/missing.js 等文件。这个短文本只用于验证 HTTP 回退;实际项目应放入构建生成的 HTML 与完整资源。
片段示例:以下站点块放在 http 上下文,假设文件目录对 Worker 可读。
server {
listen 127.0.0.1:8080;
server_name spa.test;
root /srv/spa-demo;
# 入口本身缺失时直接 404,避免再次回退形成内部循环。
location = /index.html { try_files $uri =404; }
location /assets/ { try_files $uri =404; }
# 本例没有后端;真实项目应在此配置独立代理规则。
location /api/ { return 404 "api-not-configured\n"; }
location / { try_files $uri $uri/ /index.html; }
}这里 /assets/ 不回退 HTML,避免浏览器把首页当成 JavaScript 解析。API 也单独处理,不能把未知 API 的 404 改成页面入口 200;否则客户端可能报 JSON 解析失败,真正的路径错误反而被隐藏。

验证刷新与失败路径
检查配置并重载后,在本机执行完整命令:
# 页面回退返回入口内容,资源和接口的错误不能被掩盖。
curl -sS -H 'Host: spa.test' -w 'status=%{http_code}\n' http://127.0.0.1:8080/orders/42
curl -sS -o /dev/null -H 'Host: spa.test' -w 'status=%{http_code}\n' http://127.0.0.1:8080/assets/missing.js
curl -sS -H 'Host: spa.test' -w 'status=%{http_code}\n' http://127.0.0.1:8080/api/orders预期输出:
spa-entry
status=200
status=404
api-not-configured
status=404真实前端还应在浏览器直接打开深层地址并刷新,确认路由页面、资源 URL 和应用部署基路径一致。curl 拿到入口不等于已经验证浏览器路由或脚本执行;若应用部署在 /console/ 子路径下,也应同步配置前端基路径和服务器回退 URI。
避免把首页回退扩大成全站成功
回退会让未知页面路径返回入口,前端必须自行处理不存在的页面,搜索和监控场景也可能需要真正的 404 或服务端渲染策略。发布时先部署完整资源,再切换入口,保留必要旧资源以支持缓存页面;否则回退正确仍可能因脚本缺失而白屏。