(已解决)宝塔部署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就能正常工作了。

相关推荐
_AaronWong10 分钟前
Electron 实现仿豆包划词取词功能:从 AI 生成到落地踩坑记
前端·javascript·vue.js
cxxcode10 分钟前
I/O 多路复用:从浏览器到 Linux 内核
前端
用户54330814419419 分钟前
AI 时代,前端逆向的门槛已经低到离谱 — 以 Upwork 为例
前端
JarvanMo23 分钟前
Flutter 版本的 material_ui 已经上架 pub.dev 啦!快来抢先体验吧。
前端
JohnYan27 分钟前
工作笔记-CodeBuddy应用探索
javascript·ai编程·aiops
恋猫de小郭1 小时前
AI 可以让 WIFI 实现监控室内人体位置和姿态,无需摄像头?
前端·人工智能·ai编程
哀木1 小时前
给自己整一个 claude code,解锁编程新姿势
前端
程序员鱼皮1 小时前
GitHub 关注突破 2w,我总结了 10 个涨星涨粉技巧!
前端·后端·github
UrbanJazzerati1 小时前
Vue3 父子组件通信完全指南
前端·面试
是一碗螺丝粉1 小时前
5分钟上手LangChain.js:用DeepSeek给你的App加上AI能力
前端·人工智能·langchain