问题描述:
部署成功后项目正常运行,但是一但非首页刷新就会报错:404
问题解决:
在网页的设置中的配置文件添加上图代码:重启后即可正常运行。
## 添加上这个配置
location / {
try_files $uri $uri/ @router;
index index.html;
}
location @router {
rewrite ^.*$ /index.html last;
}
原理剖析:
Vue路由模式
Vue Router有两种模式来处理页面跳转:
- Hash模式 :URL后面带有一个
#
符号,比如http://example.com/#/about
。这种方式浏览器可以直接识别,不需要服务器做特殊处理。 - 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就能正常工作了。