vue中常见的问题及解决方法总结（推荐）

有一些问题不限于 Vue，还适应于其他类型的 SPA 项目。

1. 页面权限控制和登陆验证页面权限控制

页面权限控制是什么意思呢？

就是一个网站有不同的角色，比如管理员和普通用户，要求不同的角色能访问的页面是不一样的。如果一个页面，有角色越权访问，这时就得做出限制了。

一种方法是通过动态添加路由和菜单来做控制，不能访问的页面不添加到路由表里，这是其中一种办法。具体细节请看下一节的《动态菜单》。

另一种办法就是所有的页面都在路由表里，只是在访问的时候要判断一下角色权限。如果有权限就允许访问，没有权限就拒绝，跳转到 404 页面。

思路

在每一个路由的meta属性里，将能访问该路由的角色添加到roles里。用户每次登陆后，将用户的角色返回。然后在访问页面时，把路由的meta属性和用户的角色进行对比，如果用户的角色在路由的roles里，那就是能访问，如果不在就拒绝访问。

代码示例

路由信息

routes: [
 {
 path: '/login',
 name: 'login',
 meta: {
 roles: ['admin', 'user']
 },
 component: () => import('../components/Login.vue')
 },
 {
 path: 'home',
 name: 'home',
 meta: {
 roles: ['admin']
 },
 component: () => import('../views/Home.vue')
 },
]

页面控制

// 假设角色有两种：admin 和 user
// 这里是从后台获取的用户角色
const role = 'user'
// 在进入一个页面前会触发 router.beforeEach 事件
router.beforeEach((to, from, next) => {
 if (to.meta.roles.includes(role)) {
 next()
 } else {
 next({path: '/404'})
 }
})

登陆验证

网站一般只要登陆过一次后，接下来该网站的其他页面都是可以直接访问的，不用再次登陆。我们可以通过token或cookie来实现，下面用代码来展示一下如何用token控制登陆验证。

router.beforeEach((to, from, next) => {
 // 如果有token 说明该用户已登陆
 if (localStorage.getItem('token')) {
 // 在已登陆的情况下访问登陆页会重定向到首页
 if (to.path === '/login') {
 next({path: '/'})
 } else {
 next({path: to.path || '/'})
 }
 } else {
 // 没有登陆则访问任何页面都重定向到登陆页
 if (to.path === '/login') {
 next()
 } else {
 next(`/login?redirect=${to.path}`)
 }
 }
})

2. 动态菜单

写后台管理系统，估计有不少人遇过这样的需求：根据后台数据动态添加路由和菜单。为什么这么做呢？因为不同的用户有不同的权限，能访问的页面是不一样的。

动态添加路由

利用 vue-router 的addRoutes方法可以动态添加路由。

先看一下官方介绍：

router.addRoutes

router.addRoutes(routes: Array<RouteConfig>)

动态添加更多的路由规则。参数必须是一个符合routes选项要求的数组。

举个例子：

const router = new Router({
 routes: [
 {
  path: '/login',
  name: 'login',
  component: () => import('../components/Login.vue')
 },
 {path: '/', redirect: '/home'},
 ]
})

上面的代码和下面的代码效果是一样的

const router = new Router({
 routes: [
 {path: '/', redirect: '/home'},
 ]
})

router.addRoutes([
 {
 path: '/login',
 name: 'login',
 component: () => import('../components/Login.vue')
 }
])

在动态添加路由的过程中，如果有 404 页面，一定要放在最后添加，否则在登陆的时候添加完页面会重定向到 404 页面。

类似于这样，这种规则一定要最后添加。

{path: '*', redirect: '/404'}

动态生成菜单

假设后台返回来的数据长这样：

// 左侧菜单栏数据
menuItems: [
 {
 name: 'home', // 要跳转的路由名称 不是路径
 size: 18, // icon大小
 type: 'md-home', // icon类型
 text: '主页' // 文本内容
 },
 {
 text: '二级菜单',
 type: 'ios-paper',
 children: [
  {
  type: 'ios-grid',
  name: 't1',
  text: '表格'
  },
  {
  text: '三级菜单',
  type: 'ios-paper',
  children: [
   {
   type: 'ios-notifications-outline',
   name: 'msg',
   text: '查看消息'
   },
  ]
  }
 ]
 }
]

来看看怎么将它转化为菜单栏，我在这里使用了iview的组件，不用重复造轮子。

<!-- 菜单栏 -->
<Menu ref="asideMenu" theme="dark" width="100%" @on-select="gotoPage"
accordion :open-names="openMenus" :active-name="currentPage" @on-open-change="menuChange">
 <!-- 动态菜单 -->
 <div v-for="(item, index) in menuItems" :key="index">
 <Submenu v-if="item.children" :name="index">
  <template slot="title">
  <Icon :size="item.size" :type="item.type"/>
  <span v-show="isShowAsideTitle">{{item.text}}</span>
  </template>
  <div v-for="(subItem, i) in item.children" :key="index + i">
  <Submenu v-if="subItem.children" :name="index + '-' + i">
   <template slot="title">
   <Icon :size="subItem.size" :type="subItem.type"/>
   <span v-show="isShowAsideTitle">{{subItem.text}}</span>
   </template>
   <MenuItem class="menu-level-3" v-for="(threeItem, k) in subItem.children" :name="threeItem.name" :key="index + i + k">
   <Icon :size="threeItem.size" :type="threeItem.type"/>
   <span v-show="isShowAsideTitle">{{threeItem.text}}</span>
   </MenuItem>
  </Submenu>
  <MenuItem v-else v-show="isShowAsideTitle" :name="subItem.name">
   <Icon :size="subItem.size" :type="subItem.type"/>
   <span v-show="isShowAsideTitle">{{subItem.text}}</span>
  </MenuItem>
  </div>
 </Submenu>
 <MenuItem v-else :name="item.name">
  <Icon :size="item.size" :type="item.type" />
  <span v-show="isShowAsideTitle">{{item.text}}</span>
 </MenuItem>
 </div>
</Menu>

代码不用看得太仔细，理解原理即可，其实就是通过三次v-for不停的对子数组进行循环，生成三级菜单。

不过这个动态菜单有缺陷，就是只支持三级菜单。一个更好的做法是把生成菜单的过程封装成组件，然后递归调用，这样就能支持无限级的菜单。在生菜菜单时，需要判断一下是否还有子菜单，如果有就递归调用组件。

动态路由因为上面已经说过了用addRoutes来实现，现在看看具体怎么做。

首先，要把项目所有的页面路由都列出来，再用后台返回来的数据动态匹配，能匹配上的就把路由加上，不能匹配上的就不加。最后把这个新生成的路由数据用addRoutes添加到路由表里。

const asyncRoutes = {
 'home': {
 path: 'home',
 name: 'home',
 component: () => import('../views/Home.vue')
 },
 't1': {
 path: 't1',
 name: 't1',
 component: () => import('../views/T1.vue')
 },
 'password': {
 path: 'password',
 name: 'password',
 component: () => import('../views/Password.vue')
 },
 'msg': {
 path: 'msg',
 name: 'msg',
 component: () => import('../views/Msg.vue')
 },
 'userinfo': {
 path: 'userinfo',
 name: 'userinfo',
 component: () => import('../views/UserInfo.vue')
 }
}

// 传入后台数据 生成路由表
menusToRoutes(menusData)

// 将菜单信息转成对应的路由信息 动态添加
function menusToRoutes(data) {
 const result = []
 const children = []

 result.push({
 path: '/',
 component: () => import('../components/Index.vue'),
 children,
 })

 data.forEach(item => {
 generateRoutes(children, item)
 })

 children.push({
 path: 'error',
 name: 'error',
 component: () => import('../components/Error.vue')
 })

 // 最后添加404页面 否则会在登陆成功后跳到404页面
 result.push(
 {path: '*', redirect: '/error'},
 )

 return result
}

function generateRoutes(children, item) {
 if (item.name) {
 children.push(asyncRoutes[item.name])
 } else if (item.children) {
 item.children.forEach(e => {
  generateRoutes(children, e)
 })
 }
}

动态菜单的代码实现放在 github 上，分别放在这个项目的src/components/Index.vue、src/permission.js和src/utils/index.js文件里。

3. 前进刷新后退不刷新需求一：

在一个列表页中，第一次进入的时候，请求获取数据。

点击某个列表项，跳到详情页，再从详情页后退回到列表页时，不刷新。

也就是说从其他页面进到列表页，需要刷新获取数据，从详情页返回到列表页时不要刷新。

解决方案

在App.vue设置：

 <keep-alive include="list">
  <router-view/>
 </keep-alive>

假设列表页为list.vue，详情页为detail.vue，这两个都是子组件。

我们在keep-alive添加列表页的名字，缓存列表页。

然后在列表页的created函数里添加 ajax 请求，这样只有第一次进入到列表页的时候才会请求数据，当从列表页跳到详情页，再从详情页回来的时候，列表页就不会刷新。这样就可以解决问题了。

需求二：

在需求一的基础上，再加一个要求：可以在详情页中删除对应的列表项，这时返回到列表页时需要刷新重新获取数据。

我们可以在路由配置文件上对detail.vue增加一个meta属性。

 {
  path: '/detail',
  name: 'detail',
  component: () => import('../view/detail.vue'),
  meta: {isRefresh: true}
 },

这个meta属性，可以在详情页中通过this.$route.meta.isRefresh来读取和设置。

设置完这个属性，还要在App.vue文件里设置 watch 一下$route属性。

 watch: {
 $route(to, from) {
  const fname = from.name
  const tname = to.name
  if (from.meta.isRefresh || (fname != 'detail' && tname == 'list')) {
  from.meta.isRefresh = false
 // 在这里重新请求数据
  }
 }
 },

这样就不需要在列表页的created函数里用 ajax 来请求数据了，统一放在App.vue里来处理。

触发请求数据有两个条件：

从其他页面（除了详情页）进来列表时，需要请求数据。从详情页返回到列表页时，如果详情页meta属性中的isRefresh为true，也需要重新请求数据。

当我们在详情页中删除了对应的列表项时，就可以将详情页meta属性中的isRefresh设为true。这时再返回到列表页，页面会重新刷新。

解决方案二

对于需求二其实还有一个更简洁的方案，那就是使用 router-view 的key属性。

<keep-alive>
 <router-view :key="$route.fullPath"/>
</keep-alive>

首先 keep-alive 让所有页面都缓存，当你不想缓存某个路由页面，要重新加载它时，可以在跳转时传一个随机字符串，这样它就能重新加载了。例如从列表页进入了详情页，然后在详情页中删除了列表页中的某个选项，此时从详情页退回列表页时就要刷新，我们可以这样跳转：

this.$router.push({
 path: '/list',
 query: { 'randomID': 'id' + Math.random() },
})

这样的方案相对来说还是更简洁的。

4. 多个请求下 loading 的展示与关闭

一般情况下，在 vue 中结合 axios 的拦截器控制 loading 展示和关闭，是这样的：

在App.vue配置一个全局 loading。

 <div class="app">
  <keep-alive :include="keepAliveData">
   <router-view/>
  </keep-alive>
  <div class="loading" v-show="isShowLoading">
   <Spin size="large"></Spin>
  </div>
 </div>

同时设置 axios 拦截器。

 // 添加请求拦截器
 this.$axios.interceptors.request.use(config => {
  this.isShowLoading = true
  return config
 }, error => {
  this.isShowLoading = false
  return Promise.reject(error)
 })

 // 添加响应拦截器
 this.$axios.interceptors.response.use(response => {
  this.isShowLoading = false
  return response
 }, error => {
  this.isShowLoading = false
  return Promise.reject(error)
 })

这个拦截器的功能是在请求前打开 loading，请求结束或出错时关闭 loading。

如果每次只有一个请求，这样运行是没问题的。但同时有多个请求并发，就会有问题了。

举例：

假如现在同时发起两个请求，在请求前，拦截器this.isShowLoading = true将 loading 打开。

现在有一个请求结束了。this.isShowLoading = false拦截器关闭 loading，但是另一个请求由于某些原因并没有结束。

造成的后果就是页面请求还没完成，loading 却关闭了，用户会以为页面加载完成了，结果页面不能正常运行，导致用户体验不好。

解决方案

增加一个loadingCount变量，用来计算请求的次数。

loadingCount: 0

再增加两个方法，来对loadingCount进行增减操作。

 methods: {
  addLoading() {
   this.isShowLoading = true
   this.loadingCount++
  },

  isCloseLoading() {
   this.loadingCount--
   if (this.loadingCount == 0) {
    this.isShowLoading = false
   }
  }
 }

现在拦截器变成这样：

  // 添加请求拦截器
  this.$axios.interceptors.request.use(config => {
   this.addLoading()
   return config
  }, error => {
   this.isShowLoading = false
   this.loadingCount = 0
   this.$Message.error('网络异常，请稍后再试')
   return Promise.reject(error)
  })

  // 添加响应拦截器
  this.$axios.interceptors.response.use(response => {
   this.isCloseLoading()
   return response
  }, error => {
   this.isShowLoading = false
   this.loadingCount = 0
   this.$Message.error('网络异常，请稍后再试')
   return Promise.reject(error)
  })

这个拦截器的功能是：

每当发起一个请求，打开 loading，同时loadingCount加1。

每当一个请求结束，loadingCount减1，并判断 loadingCount是否为 0，如果为 0，则关闭 loading。

这样即可解决，多个请求下有某个请求提前结束，导致 loading 关闭的问题。

5. 表格打印

打印需要用到的组件为 print-js

普通表格打印

一般的表格打印直接仿照组件提供的例子就可以了。

printJS({
 printable: id, // DOM id
 type: 'html',
 scanStyles: false,
})

element-ui 表格打印（其他组件库的表格同理）

element-ui 的表格，表面上看起来是一个表格，实际上是由两个表格组成的。

表头为一个表格，表体又是个表格，这就导致了一个问题：打印的时候表体和表头错位。

另外，在表格出现滚动条的时候，也会造成错位。

解决方案

我的思路是将两个表格合成一个表格，print-js组件打印的时候，实际上是把 id 对应的 DOM 里的内容提取出来打印。所以，在传入 id 之前，可以先把表头所在的表格内容提取出来，插入到第二个表格里，从而将两个表格合并，这时候打印就不会有错位的问题了。

function printHTML(id) {
 const html = document.querySelector('#' + id).innerHTML
 // 新建一个 DOM
 const div = document.createElement('div')
 const printDOMID = 'printDOMElement'
 div.id = printDOMID
 div.innerHTML = html

 // 提取第一个表格的内容 即表头
 const ths = div.querySelectorAll('.el-table__header-wrapper th')
 const ThsTextArry = []
 for (let i = 0, len = ths.length; i < len; i++) {
  if (ths[i].innerText !== '') ThsTextArry.push(ths[i].innerText)
 }

 // 删除多余的表头
 div.querySelector('.hidden-columns').remove()
 // 第一个表格的内容提取出来后已经没用了 删掉
 div.querySelector('.el-table__header-wrapper').remove()

 // 将第一个表格的内容插入到第二个表格
 let newHTML = '<tr>'
 for (let i = 0, len = ThsTextArry.length; i < len; i++) {
  newHTML += '<td style="text-align: center; font-weight: bold">' + ThsTextArry[i] + '</td>'
 }

 newHTML += '</tr>'
 div.querySelector('.el-table__body-wrapper table').insertAdjacentHTML('afterbegin', newHTML)
 // 将新的 DIV 添加到页面 打印后再删掉
 document.querySelector('body').appendChild(div)

 printJS({
  printable: printDOMID,
  type: 'html',
  scanStyles: false,
  style: 'table { border-collapse: collapse }' // 表格样式
 })

 div.remove()
}

6. 下载二进制文件

平时在前端下载文件有两种方式，一种是后台提供一个 URL，然后用window.open(URL)下载，另一种就是后台直接返回文件的二进制内容，然后前端转化一下再下载。

由于第一种方式比较简单，在此不做探讨。本文主要讲解一下第二种方式怎么实现。

第二种方式需要用到 Blob 对象， mdn 文档上是这样介绍的：

Blob 对象表示一个不可变、原始数据的类文件对象。Blob 表示的不一定是JavaScript原生格式的数据

具体使用方法

axios({
 method: 'post',
 url: '/export',
})
.then(res => {
 // 假设 data 是返回来的二进制数据
 const data = res.data
 const url = window.URL.createObjectURL(new Blob([data], {type: "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet"}))
 const link = document.createElement('a')
 link.style.display = 'none'
 link.href = url
 link.setAttribute('download', 'excel.xlsx')
 document.body.appendChild(link)
 link.click()
 document.body.removeChild(link)
})

打开下载的文件，看看结果是否正确。

一堆乱码...

一定有哪里不对。

最后发现是参数 responseType 的问题，responseType 它表示服务器响应的数据类型。由于后台返回来的是二进制数据，所以我们要把它设为 arraybuffer， 接下来再看看结果是否正确。

axios({
 method: 'post',
 url: '/export',
 responseType: 'arraybuffer',
})
.then(res => {
 // 假设 data 是返回来的二进制数据
 const data = res.data
 const url = window.URL.createObjectURL(new Blob([data], {type: "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet"}))
 const link = document.createElement('a')
 link.style.display = 'none'
 link.href = url
 link.setAttribute('download', 'excel.xlsx')
 document.body.appendChild(link)
 link.click()
 document.body.removeChild(link)
})

这次没有问题，文件能正常打开，内容也是正常的，不再是乱码。

根据后台接口内容决定是否下载文件

作者的项目有大量的页面都有下载文件的需求，而且这个需求还有点变态。

具体需求如下

• 如果下载文件的数据量条数符合要求，正常下载（每个页面限制下载数据量是不一样的，所以不能在前端写死）。
• 如果文件过大，后台返回 { code: 199999, msg: '文件过大，请重新设置查询项', data: null }，然后前端再进行报错提示。

先来分析一下，首先根据上文，我们都知道下载文件的接口响应数据类型为 arraybuffer。返回的数据无论是二进制文件，还是 JSON 字符串，前端接收到的其实都是 arraybuffer。所以我们要对 arraybuffer 的内容作个判断，在接收到数据时将它转换为字符串，判断是否有 code: 199999。如果有，则报错提示，如果没有，则是正常文件，下载即可。具体实现如下：

xios.interceptors.response.use(response => {
  const res = response.data
  // 判断响应数据类型是否 ArrayBuffer，true 则是下载文件接口，false 则是正常接口
  if (res instanceof ArrayBuffer) {
    const utf8decoder = new TextDecoder()
    const u8arr = new Uint8Array(res)
    // 将二进制数据转为字符串
    const temp = utf8decoder.decode(u8arr)
    if (temp.includes('{code:199999')) {
      Message({
       // 字符串转为 JSON 对象
        message: JSON.parse(temp).msg,
        type: 'error',
        duration: 5000,
      })

      return Promise.reject()
    }
  }
  // 正常类型接口，省略代码...
  return res
}, (error) => {
  // 省略代码...
  return Promise.reject(error)
})

7. 自动忽略 console.log 语句

export function rewirteLog() {
  console.log = (function (log) {
    return process.env.NODE_ENV == 'development'? log : function() {}
  }(console.log))
}

在 main.js 引入这个函数并执行一次，就可以实现忽略 console.log 语句的效果。

总结

到此这篇关于vue中常见的问题及解决方法的文章就介绍到这了,更多相关vue常见问题内容请搜索我们以前的文章或继续浏览下面的相关文章希望大家以后多多支持我们！