用 Nginx 的 try_files 解决单页应用刷新 404:配置与验证手记

举报
yd_2703867848 发表于 2026/11/09 10:13:59 2026/11/09
【摘要】 单页应用刷新子路径时 Nginx 会按文件查找并返回 404,本文介绍用 try_files 把子路径请求交给 index.html 兜底的配置方法与验证步骤。

一、问题背景

单页应用打包后通常只有一个 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 的问题,也就不需要这条配置。

【声明】本内容来自华为云开发者社区博主,不代表华为云及华为云开发者社区的观点和立场。转载时必须标注文章的来源(华为云社区)、文章链接、文章作者等基本信息,否则作者和本社区有权追究责任。如果您发现本社区中有涉嫌抄袭的内容,欢迎发送邮件进行举报,并提供相关证据,一经查实,本社区将立刻删除涉嫌侵权内容,举报邮箱: cloudbbs@huaweicloud.com
  • 点赞
  • 收藏
  • 关注作者

评论(0)

0/1000
抱歉,系统识别当前为高风险访问,暂不支持该操作

全部回复

上滑加载中

设置昵称

在此一键设置昵称,即可参与社区互动!

*长度不超过10个汉字或20个英文字符,设置后3个月内不可修改。

*长度不超过10个汉字或20个英文字符,设置后3个月内不可修改。