Vue路由History mode模式中页面无法渲染的原因及解决

╰+哭是因爲堅強的太久メ 2021-12-17 18:25 527阅读 0赞

# Vue下路由History mode导致页面无法渲染的原因 #

用 Vue.js + vue-router 创建单页应用，是非常简单的。使用 Vue.js ，我们已经可以通过组合组件来组成应用程序，当你要把 vue-router 添加进来，我们需要做的是，将组件(components)映射到路由(routes)，然后告诉 vue-router 在哪里渲染它们。

一般开发的单页应用的URL都会带有\#号的hash模式，因为整个应用本身而言就只有一个HTML，其他的都是通过router来渲染。如果因为业务需要，或者单纯是觉得带\#号不美观，那么可以使用history模式，简单而言就是在router的配置文件index.js中添加如下一行代码：

history: mode

没错，这样URL不再会有\#号，你会发现整个地址栏回到了你熟悉的那个样子，不过，接下来介绍的就非常的重要了，可能很多刚入门的新人或多或少都会遇见这么一两个坑…

## 页面无法渲染 ##

这里以我写的一个项目为例子，当我开启history模式的时候，我并没有对路由进行任何处理，在Dev阶段一切都是正常的，可是打包之后，访问项目路径：

*sdp.driver.com/driver/*

会发现页面一片空白，但是静态文件都能够正常的引用，因为使用了YII中的模块，所以除了域名之外，还会带有driver模块名。一般很多人创建的项目都放在了根目录下面，也就是：

*sdp.driver.com*

这样的一种形式，没问题。可是如果配置了模块，或者放置在了子文件夹下面，那么就会出问题。其实，这是因为router无法找到路径中的组件，所以也就无法渲染了。只需要修改router中的index.js，在每个path中加上你项目名称就行了，这样就能够成功了。

![aHR0cHM6Ly91cGxvYWQtaW1hZ2VzLmppYW5zaHUuaW8vdXBsb2FkX2ltYWdlcy8yMTkxMjUxLWUwMWVkZmFmYjNmOTY4NWE_aW1hZ2VNb2dyMi9hdXRvLW9yaWVudC9zdHJpcCU3Q2ltYWdlVmlldzIvMi93LzYwMC9mb3JtYXQvd2VicA][]

index.js

最后的页面效果：

![aHR0cHM6Ly91cGxvYWQtaW1hZ2VzLmppYW5zaHUuaW8vdXBsb2FkX2ltYWdlcy8yMTkxMjUxLTk5YThkYTE4ZTExM2FhMWQ_aW1hZ2VNb2dyMi9hdXRvLW9yaWVudC9zdHJpcCU3Q2ltYWdlVmlldzIvMi93LzQ1NS9mb3JtYXQvd2VicA][]

效果图

## 404错误 ##

在History mode下，如果直接通过地址栏访问路径，那么会出现404错误，这是因为这是单页应用（废话）…其实是因为调用了history.pushState API 所以所有的跳转之类的操作都是通过router来实现的，解决这个问题很简单，只需要在后台配置如果URL匹配不到任何静态资源，就跳转到默认的index.html。具体配置如下：

Apache

<IfModule mod_rewrite.c>
      RewriteEngine On
      RewriteBase /
      RewriteRule ^index\.html$ - [L]
      RewriteCond %{REQUEST_FILENAME} !-f
      RewriteCond %{REQUEST_FILENAME} !-d
      RewriteRule . /index.html [L]
    </IfModule>

nginx

location / {
      try_files $uri $uri/ /index.html;
    }

[Node.js][] (Express)

## 关于每次点击链接都要刷新页面的问题 ##

众所周知，开发单页应用就是因为那丝般顺滑的体验效果，如果每次点击都会刷新页面…  
出现这个的原因是因为使用了window.location来跳转，只需要使用使用router提供的方法，就能够解决这个问题：

在main.js中配置中将router绑定到全局

Vue.prototype.router = router;

之后都使用如下的方式来控制跳转

this.router.push('driver/service');

好啦，这次关于Vue路由的“坑”就介绍到这里了，以后会发表更多的优质文章，如果对你有所帮助，请点击赞，谢谢。

小礼物走一走，来简书关注我

赞赏支持

[ Vue][Vue]

[aHR0cHM6Ly91cGxvYWQtaW1hZ2VzLmppYW5zaHUuaW8vdXBsb2FkX2ltYWdlcy8yMTkxMjUxLWUwMWVkZmFmYjNmOTY4NWE_aW1hZ2VNb2dyMi9hdXRvLW9yaWVudC9zdHJpcCU3Q2ltYWdlVmlldzIvMi93LzYwMC9mb3JtYXQvd2VicA]: /images/20211214/3304a34aebb6422988f32a24602d53f7.png
[aHR0cHM6Ly91cGxvYWQtaW1hZ2VzLmppYW5zaHUuaW8vdXBsb2FkX2ltYWdlcy8yMTkxMjUxLTk5YThkYTE4ZTExM2FhMWQ_aW1hZ2VNb2dyMi9hdXRvLW9yaWVudC9zdHJpcCU3Q2ltYWdlVmlldzIvMi93LzQ1NS9mb3JtYXQvd2VicA]: /images/20211214/7345653b0b5e40cbbfed9a8460230f72.png
[Node.js]: https://link.jianshu.com/?t=http%3A%2F%2Flib.csdn.net%2Fbase%2Fnodejs
[Vue]: https://www.jianshu.com/nb/20249909