nginx 部署vue项目,路由模式为history时,页面刷新404问题

文章介绍了在Nginx中部署Vue单页应用时遇到的404错误,解释了root和alias配置的区别,以及try_files指令的作用。通过alias配合try_files确保请求重定向到index.html,从而解决刷新时的404问题。

摘要生成于 C知道 ,由 DeepSeek-R1 满血版支持, 前往体验 >

情况说明

nginx部署vue项目,文件放在html下的dist文件夹中
在这里插入图片描述
nginx.conf 文件中,server 里配置文件的位置、请求跨域等信息
在这里插入图片描述

本案例解决方法

在启动项目后因为配置的是root,首先是找不到html下面的sys-test文件夹,再经过配置修改为alias配置后,刷新又会报404错误,最终配置为如下,成功解决

在这里插入图片描述

配置解释

为什么会出现404的情况

因为打包部署后,地址栏的地址只是vue的路由,并不是真的文件目录地址。所有的路由都是依赖于SPA单页应用的index.html。所以当刷新时,按照地址栏的地址,找不到对应的文件,就产生404。
解决: 在nginx里进行try_files配置,让其统一去查找index.html。(就是按照路径找不到时,就去找index.html)

root 和 alias 的区别

主要区别在于nginx如何解释location后面的uri,这会使两者分别以不同的方式将请求映射到服务器文件上。
如以下root配置

location /sys-test {
    root   html;
    index  index.html;
}

这个去找的地方就是 root 配置的值和 location 配置的值相加,也就是去 html/sys-test 下寻找

如果是以下 alias 配置

location /sys-test {
    alias html/dist;
    index  index.html;
    try_files $uri $uri/ /dist/index.html;
}

alias 配置后,资源的路径就是 alias 后面配置的路径,也就是去 html/dist 下去寻找

try_files 配置的作用

try_files配置的作用 就是按顺序检查文件是否存在
配上一个简单的例子进行解释:

下面的配置意思就是:
当我们访问一个地址为 http://localhost:8888/sys-test/login 
1. 先通过alias 确定路径 html/dist 
2. 然后通过try_files配置,首先会在html/dist下去找 $uri,也就是login这个文件
3. 这个时候因为没有login文件,就会去找 $uri/ ,也就是 /login/ 这个文件目录
4. 如果还是没找到,就会将其重定向到 @router
5. 在定义的 @router 里,我们将其都指向 /dist 文件夹下的 index.html。这样就成功解决问题!
/*
location /sys-test {
    alias html/dist/;
    index   index.html;
    try_files  $uri $uri/ /dist/index.html;
    // $uri 代表访问的文件地址
    // $uri/ 代表访问的文件目录
}
*/

location /sys-test {
    alias html/dist/;
    index   index.html;
    try_files  $uri $uri/  @router;
    // $uri 代表访问的文件地址
    // $uri/ 代表访问的文件目录
}
location @router {
     rewrite ^.*$ /dist/index.html;
     // 匹配所有  /dist/index.html;
}

友情提示

如若是自行配置nginx时,遇到一些问题,可先找到logs文件夹下的error.log文件,查看错误信息,定位错误原因,进行调整或百度

### Vue History Mode 下 Nginx 配置避免 404 的解决方案 当使用 Vue Router 的 `history` 模式,URL 不再带有 `#` 符号,这使得 URL 更加美观和语义化。然而,在这种模式下,如果用户直接访问某个路径或者刷新页面,服务器会尝试查找对应的文件并返回 404 错误,因为这些路径实际上是由前端路由处理的。 为了避免这种情况发生,可以通过配置 Nginx 将未匹配到静态资源的请求重定向回应用入口文件(通常是 `index.html`)。以下是具体的配置方法: #### 修改 Nginx 配置 在 Nginx 中,通过设置 `location` 块来捕获所有未找到对应文件的请求,并将其转发给 `index.html` 文件。以下是一个典型的配置示例[^2]: ```nginx server { listen 80; server_name your-domain.com; root /path/to/your/vue/app/dist; # 替换为实际部署项目的根目录 index index.html; location / { try_files $uri /index.html; # 如果找不到文件,则加载 index.html } error_page 404 /404.html; # 可选:自定义错误页 location ~* \.(?:ico|css|js|gif|jpe?g|png|woff2?)$ { # 处理静态资源缓存策略 expires max; add_header Cache-Control "public, must-revalidate"; } } ``` 上述配置的关键部分在于 `try_files $uri /index.html` 这一行。它告诉 Nginx 对于任何无法映射到具体文件或目录的 URI 请求都应返回 `index.html` 页面,从而让前端框架接管后续的路由逻辑。 完成修改之后记得重启 Nginx 来使更改生效: ```bash sudo systemctl restart nginx ``` 另外需要注意的是,如果你的应用运行在一个子路径而非网站根路径上 (比如 http://example.com/myapp/) ,那么还需要调整 Vue 路由的基础路径以及相应地更新 Nginx 设置中的 `root` 和 `location` 参数[^3]。 #### 测试配置有效性 为了验证新配置是否正常工作,可以执行如下操作: 1. 构建生产环境下的 Vue 应用 (`npm run build`); 2. 把构建后的产物上传至指定的服务端位置; 3. 使用浏览器打开任意非首页链接地址进行测试——即使手动输入该网址也应该能够正确显示内容而不是遇到 404 错误。
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值