用 Nginx 的 try_files 解决单页应用刷新 404:配置与验证手记
一、问题背景
单页应用打包后通常只有一个 index.html 和若干静态资源文件。直接访问站点的根路径时,Nginx 可以正常返回 index.html;但如果用户刷新了前端路由对应的子路径,例如 dashboard,或者直接在地址栏输入子路径地址,Nginx 会按照文件路径去磁盘上查找一个名叫 dashboard 的文件,找不到就返回 404。
二、准备工作
一台已经安装 Nginx 的弹性云服务器,一个已完成打包的单页应用 dist 目录,目录里至少有 index.html 和 app.js。把 dist 目录上传到服务器,例如放到 /var/www/spa 目录。
三、配置方法
在 Nginx 的 server 配置里,把根目录指向 dist 目录,并对根路径 location 设置 try_files 指令,如下:
server {
listen 80;
server_name 你的弹性云服务器公网地址;
root /var/www/spa;
index index.html;
location / {
try_files $uri $uri/ /index.html;
}
}
这条指令的含义是:先尝试匹配真实文件,再尝试匹配目录,最后都交给 index.html,由前端路由接管渲染。注意不要把接口路径也交给 index.html,接口建议单独写一个 location /api/,用 proxy_pass 转发到后端服务。
四、验证方法
先执行 nginx -t 检查配置语法,通过后再重载 Nginx。接着用 curl 分别访问服务器根路径和子路径地址(地址写为服务器公网地址加路径,不要加任何协议头),两次都应返回 index.html 的内容;再访问一个不存在的静态文件路径,应返回前端自己的 404 页面,而不是 Nginx 默认的 404 页。
五、注意事项
浏览器可能缓存了旧的 index.html,验证时建议使用无痕窗口;如果前端使用 hash 路由而不是 history 路由,就不会出现刷新 404 的问题,也就不需要这条配置。
- 点赞
- 收藏
- 关注作者
评论(0)