Vue开发中出现Loading Chunk Failed 踩坑纪实

最新推荐文章于 2024-09-18 10:33:50 发布

Yukon~

最新推荐文章于 2024-09-18 10:33:50 发布

阅读量4.4k

点赞数 4

文章标签： vue.js

本文链接：https://blog.csdn.net/weixin_54079992/article/details/123885157

版权

本文探讨了在前端开发中遇到的异步组件加载错误——LoadingChunkFailed，分析了其由资源替换导致的原因，并提出了解决方案。在路由报错时，通过前端强制刷新页面和预加载策略来降低错误发生的概率。同时，强调了设置缓存策略的重要性，以防止指向已删除的旧资源。最后，提供了复现问题的方法和代码实现。

摘要由CSDN通过智能技术生成

报错现象:

某天测试反应在点击页签的时候出现了 Loading Chunk Failed 的错误，经过本人百度分析后判断是异步组件在发包时旧资源被替换的问题，然后一通CV操作之后发现问题还是存在，于是便有如下探究。

发生原因

用户在发包前进入了页面（也就是请求到了 index.html ），并且在 index.html 中可以得知将来要请求的异步组件的名字叫 a.js ，当服务器这时候发包，并且清空掉了 a.js 这个资源，改名叫 a1.js 。发包之后用户点击 a.js 对应的组件时，浏览器拿着先前在 index.html 得知的 a.js 这个名字去服务器请求资源就得到了以上的 Loading Chunk Failed 报错。
正常的生产上线流程可能存在静态资源和页面分属不同服务器,应该是先全量部署静态资源（各种js，css，图片），不清空旧资源，然后再部署页面。但如果清空掉旧资源就可能导致报错。
如果在测试环境中可能会采取清空覆盖掉旧资源，这个时候就必须要前端进行控制了。

解决思路

在监听到路由报错的时候，前端强制刷新页面，重新获取index.html和对应的静态资源路径。
设置preFetch，网络空闲的时候就请求资源，可以大幅降低报错的几率。

触发bug

想要解决问题首先就是得复现问题，涉及到发包上线的测试和验证都有点小尴尬，因此提供下个人思路

最直接的就是你开个页面，然后控制台网络禁用掉缓存，然后发包后进入其他异步组件触发bug。
如果想要触发 onError 这个钩子的话，直接断开 devServer 就可以了。
本地复现的话就是开个本地服务器，然后进入页面，把 dist 文件夹中对应的js文件删去即可触发。

代码实现

 /* 正则使用'\S'而不是'\d' 为了适配写魔法注释的朋友，写'\d'遇到魔法注释就匹配不成功了。
  * 使用reload方法而不是replace原因是replace还是去请求之前的js文件，会导致循环报错。
  * reload会刷新页面， 请求最新的index.html以及最新的js路径。
  * 直接修改location.href或使用location.assign或location.replace，和router.replace同理， 
  * 在当前场景中请求的依然是原来的js文件，区别仅有浏览器的历史栈。因此必须采用reload.
  * reload()有个特点是当你在A页面试图进入B页面的时候报错，会在A页面刷新，因此在刷新后需要手动书写逻辑
  * 进入B页面，可以在router.onReady()方法里面书写
  * 为了避免在特殊情况下服务器丢失资源导致无限报错刷新，做了一步控制，仅尝试一次进入B页面，
  * 如果不成功就只刷新A页面，停留在当前的A页面。
  */
 
 
 router.onError((error) => {
   const jsPattern = /Loading chunk (\S)+ failed/g
   const cssPattern = /Loading CSS chunk (\S)+ failed/g
   const isChunkLoadFailed = error.message.match(jsPattern || cssPattern)
   const targetPath = router.history.pending.fullPath
   if (isChunkLoadFailed) {
     localStorage.setItem('targetPath', targetPath)
     window.location.reload()
   }
 })
 
 router.onReady(() => {
   const targetPath = localStorage.getItem('targetPath')
   const tryReload = localStorage.getItem('tryReload')
   if (targetPath) {
     localStorage.removeItem('targetPath')
     if (!tryReload) {
       router.replace(targetPath)
       localStorage.setItem('tryReload', true)
     } else {
       localStorage.removeItem('tryReload')
     }
   }
 })

一点思考

我之前提到过异步组件而不是路由懒加载导致了这个问题的发生，有趣的是，当你子组件是用懒加载方式进行，并且没有设置或者关闭了preFetch，且之前没有缓存。很可能也会报这种错。在网络中和路由懒加载一样是报 404 找不到对应资源，区别就是不会报 loadingChunkError 的错误。

设置缓存策略中页面一定要对页面( inedx.html )设置no cache no store，避免依然指向旧的已被删除的资源，只有Get方式获取的资源才可以设置缓存策略。