(已解决)宝塔部署Vue项目时非首页刷新404

问题描述:

部署成功后项目正常运行,但是一但非首页刷新就会报错:404

问题解决:

在网页的设置中的配置文件添加上图代码:重启后即可正常运行。

复制代码
## 添加上这个配置
 
location / {
  try_files $uri $uri/ @router;
  index index.html;
}
 
location @router {
  rewrite ^.*$ /index.html last;
}
原理剖析:

Vue路由模式

Vue Router有两种模式来处理页面跳转:

  1. Hash模式 :URL后面带有一个#符号,比如http://example.com/#/about。这种方式浏览器可以直接识别,不需要服务器做特殊处理。
  2. History模式 :URL看起来更"干净",没有#符号,比如http://example.com/about。这种方式需要服务器的帮助来处理这些URL。

为什么刷新会出现404?

当你使用History模式部署Vue应用时,如果直接刷新页面或者通过链接进入非首页,服务器会尝试查找实际的文件或目录。但在SPA(单页应用)中,所有的页面实际上是动态生成的,服务器上并没有对应的具体文件或目录。因此,服务器找不到对应的文件,就会返回404错误。

如何解决404?

要解决这个问题,我们需要告诉服务器:"如果找不到具体的文件或目录,请直接返回index.html。"这是因为SPA中的所有页面都是基于index.html动态生成的。

Nginx配置的作用

我们添加的那段Nginx配置就是用来实现这一点的:

  • try_files $uri $uri/ @router;:尝试找到请求的文件或目录,如果没有找到,就交给@router处理。
  • rewrite ^.*$ /index.html last;:将所有找不到的请求重定向到index.html。

这样一来,无论用户刷新页面还是直接通过链接进入其他页面,服务器都会返回index.html,然后前端的Vue Router就能正常工作了。

相关推荐
程序员Sunday2 小时前
JavaScript 事件循环面试题,宏任务与微任务怎么执行|Sunday面试指南
开发语言·javascript·面试·校招·事件循环·程序员sunday
Setsuna_F_Seiei3 小时前
前端转型 Agent 开发 06 之 Agent Memory 记忆系统(让 Agent 更智能,更懂你)
前端·agent·ai编程
志尊宝3 小时前
Vue3 零基础每日笔记(073):keep-alive 页面缓存实战——列表页返回不丢状态
vue.js·笔记·缓存·#vue #前端 #前端开发·#javascript·#vue.js
zhangzeyuaaa3 小时前
Ruby 多线程、GVL(GIL)与 Mutex 完全指南
开发语言·前端·ruby
默_笙4 小时前
🌊 向量库和 ES 都查不出"关系",我只好给奶茶建了一张人脉网
前端·javascript
优选资讯4 小时前
标签打印软件怎么对接 Excel 数据
前端·excel
思无邪665 小时前
用 AI 做 JS 逆向:从抓包到复现的完整方法论
开发语言·javascript·人工智能
一个风轻云淡5 小时前
GCC 和 GDB命令简单解读
java·linux·前端
u0111026756 小时前
图片处理接口如何统一错误信息 前端提示与后端错误码设计
前端·状态模式
福兮说6 小时前
浏览器里把 iPhone 的 HEIC 转成 JPG:Chrome 解不开、转完大了七成、拍摄时间全丢,六个坑实测
前端·javascript·图像处理·chrome·ios·iphone·heic