vue项目上线路径跳转无效(404问题)的解决

 更新时间:2025年10月25日 10:50:14   作者:Alice_sy314  
文章主要介绍了两种解决Vue Router在Nginx部署后路由无法跳转问题的方法:法一是在Vue Router中将路由模式改为hash模式,利用URL的hash部分来模拟完整URL,这样不会向后端发送请求;法二是在Nginx中配置路由,将所有请求重定向到index.html,以支持history模式的Vue Router

在近期做的一个小项目中,本地路由跳转没有任何问题,使用nginx部署上线后出现很多路由无法跳转的问题。

经过一番研究,发现可以通过以下两种方式解决。

一、将路由改为hash模式

vue-router 默认 hash 模式 —— 使用 URL 的 hash 来模拟一个完整的 URL,于是当 URL 改变时,页面不会向后端发出请求。

为什么hash模式下没有问题

router hash 模式我们都知道是用符号#表示的,如 website.com/#/login, hash 的值为 #/login

它的特点在于:hash 虽然出现在 URL 中,但不会被包括在 HTTP 请求中,对服务端完全没有影响,因此改变 hash 不会重新向服务端发送请求。而改变hash,在hash模式中会被hashChange方法所捕获,在vue中会触发页面的修改。

hash 模式下,仅 hash 符号之前的内容会被包含在请求中,如 website.com/#/login 只有 website.com 会被包含在请求中 ,因此对于服务端来说,即使没有配置location,也不会返回404错误

具体操作:找到router文件夹下的index.js文件,将mode改为hash

二、history模式后端配置nginx

如果觉得hash模式的路由模式显示在地址栏有 “#” 不好看,想使用history模式,就需要配置nginx。

为什么history模式下有问题

Vue是属于单页应用(SPA)

而SPA是一种网络应用程序,所有与用户交互都是通过动态重写当前页面来实现页面变化的,前面我们也看到了,不管我们应用有多少页面,构建物都只会产出一个index.html

现在,我们回头来看一下我们的nginx配置:

server {
  listen  80;
  server_name  www.xxx.com;

  location / {
    index  /data/dist/index.html;
  }
}

可以根据 nginx 配置得出,当我们在地址栏输入 www.xxx.com 时,

这时会打开我们 dist 目录下的 index.html 文件,然后我们在跳转路由进入到 www.xxx.com/login,

关键在这里,当我们在 www.xxx.com/login 页执行刷新操作,nginx location 是没有相关/login配置的,所以就会出现 404 的情况。

因此需要重新配置nginx,将任意页面都重定向到 index.html

总结

以上为个人经验,希望能给大家一个参考,也希望大家多多支持脚本之家。

相关文章

  • Vue如何实现u-form多个form表单同时校验

    Vue如何实现u-form多个form表单同时校验

    在 Vue 项目中使用 UView UI 的 u-form 组件时,多个表单同时校验的需求非常常见,本文主要介绍了如何使用 u-form 组件实现多个表单同时校验,需要的可以参考一下
    2025-01-01
  • 详解vue3结合ts项目中使用mockjs

    详解vue3结合ts项目中使用mockjs

    这篇文章主要为大家介绍了vue3结合ts项目中使用mockjs示例详解,有需要的朋友可以借鉴参考下,希望能够有所帮助,祝大家多多进步,早日升职加薪
    2023-07-07
  • 详解vue项目打包步骤

    详解vue项目打包步骤

    这篇文章主要介绍了vue项目打包步骤,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友们下面随着小编来一起学习学习吧
    2019-03-03
  • vue实现下拉加载其实没那么复杂

    vue实现下拉加载其实没那么复杂

    这篇文章主要给大家介绍了关于vue实现下拉加载的相关资料,文中通过示例代码介绍的非常详细,对大家学习或者使用vue具有一定的参考学习价值,需要的朋友们下面来一起学习学习吧
    2019-08-08
  • 解决vue修改数据页面不重新渲染问题

    解决vue修改数据页面不重新渲染问题

    这篇文章详细介绍了vue渲染机制和如何解决数据修改页面不刷新问题的多种方法,想了解更多的小伙伴可以借鉴阅读
    2023-03-03
  • 关于Vue3路由push跳转问题(解决Vue2this.$router.push失效)

    关于Vue3路由push跳转问题(解决Vue2this.$router.push失效)

    这篇文章主要介绍了Vue3路由push跳转问题(解决Vue2this.$router.push失效),本文给大家介绍的非常详细,对大家的学习或工作具有一定的参考借鉴价值,需要的朋友可以参考下
    2022-07-07
  • 详解lottie动画在vue中的应用

    详解lottie动画在vue中的应用

    Lottie 是一个适用于 Android、iOS、Web 和 Windows 的库,它使用 Bodymovin 解析导出为 JSON 的 Adobe After Effects 动画,下面我们就来看看它在vue中的是如何应用的吧
    2023-12-12
  • Vue中使用Element UI的Table组件实现嵌套表格功能

    Vue中使用Element UI的Table组件实现嵌套表格功能

    这篇文章主要介绍了Vue中使用Element UI的Table组件实现嵌套表格功能,演示如何在Vue中使用Element UI的Table组件实现嵌套表格,本文通过实例代码给大家介绍的非常详细,对大家的学习或工作具有一定的参考借鉴价值,需要的朋友参考下吧
    2024-01-01
  • Vue对象赋值视图不更新问题及解决方法

    Vue对象赋值视图不更新问题及解决方法

    这篇文章主要介绍了Vue对象赋值视图不更新问题及解决方法,本文给大家介绍的非常详细,具有一定的参考借鉴价值,需要的朋友可以参考下
    2019-06-06
  • Vue 集成 PDF.js 实现 PDF 预览和添加水印的步骤

    Vue 集成 PDF.js 实现 PDF 预览和添加水印的步骤

    这篇文章主要介绍了如何在 Vue 中集成 Mozilla/PDF.js ,实现自定义的 PDF 预览器,以及给被预览的 PDF 添加水印
    2021-01-01

最新评论