告别 hash 路由，迎接 history 路由

博客地址：https://ainyi.com/69

三月来了，春天还会远吗、、

在这里，隆重宣布本博客告别 Vue 传统的 hash 路由，迎接好看而优雅的 history 路由~~

映照官方说法

vue-router 默认 hash 模式 —— 使用 URL 的 hash 来模拟一个完整的 URL，因而当 URL 改变时，页面不会从新加载
若是不想要很丑的 hash，咱们能够用路由的 history 模式，这种模式充分利用 history.pushState API 来完成 URL 跳转而无须从新加载页面

export default new Router({
  mode: 'history',
  routes: [...]
)}

当使用 history 模式时，URL 就像正常的 url，例如 https://ainyi.com/about，好看又优雅！

不过这种模式要玩好，还须要后台配置支持。由于咱们的应用是个单页客户端应用，若是后台没有正确的配置，当用户在浏览器直接访问 https://ainyi.com/about 就会返回 404，由于后端没有 /about 相应的拦截器，天然 404

因此，要在服务端增长一个覆盖全部状况的候选资源：若是 URL 匹配不到任何静态资源，则应该返回同一个 index.html 页面，这个页面就是 app 依赖的页面

后端实现

本博客后端使用的是 java 的 ssm 框架，本来只作了后端接口，只提供接口

对于诸如 /about 的 url，SpringMVC 的 @RequestMapping() 没有作映射，天然是报 404 错误的

考虑到除了接口，其余访问的 history 全都是返回 404 页面，想到一个方法，就是直接作 404 页面的跳转转发，这就解决了 history 路由的问题

就是在 web.xml 中进行 404 页面的配置跳转，在 web-app 标签中配置 error-page

<web-app> 
  ...
<!-- 未匹配到 url 的跳转页面，用于 vue history 路由，未匹配的路径自动转发到 index.html -->
  <error-page>
    <error-code>404</error-code>
    <location>/index.html</location>
  </error-page>
</web-app>

完美，

但又有一个问题出现了，点击跳转能够进入二级路由，例如进入了 https://ainyi.com/tag/vue

当点击刷新的时候，会报一个找不到资源的错误，也就是 js 静态资源没找到 qaq

这就要前端来解决这个问题

刷新找不到资源

因为以前是使用 hash 路由，npm run build 打包以后，直接打开 index.html 会报找不到资源的状况，这我在以前写的博客记录解决方案：https://ainyi.com/47

当时是这么作的：

文件路径出错解决：在 config 的 index.js 下 build 的设置：assetsPublicPath: ‘./’,

而现在变成 history 路由，此字段应设置成 assetsPublicPath: ‘/’

缘由以下：

'./' 是指用户所在的当前目录（相对路径）
'/' 是指根目录，也就是项目的根目录
对于 hash 模式，根路径是固定的，就是项目的根目录
可是 history 模式下，以 / 开头的嵌套路径会被看成根路径
因此当使用 './' 引入文件，就会找不到文件了
由于文件自己就是在项目根目录下的，并不在嵌套 history 的路径目录下

设置好以后，从新打包，测试，部署上线，完美解决~

提醒

后端作了 404 页面自动跳转到 index.html 以后，服务器就再也不返回 404 错误页面，由于对于全部路径都会返回 index.html 文件

为了不这种状况，应该在 vue-router 里面设置没法匹配正确路由的状况跳转到前端的 404 页面

export default new Router({
  mode: 'history',
  routes: [
    // TODO
    {
      path: '*',
      component: () => import('../components/NotFound'),
      name: 'NotFound',
      meta: {title: '404 - 找不到页面'},
    }
  ]
)}

博客地址：https://ainyi.com/69