vue项目打包后,由于html被缓存导致出现白屏的处理方案
作者:胖子liu
背景
vue线上的项目修改打包,重新部署后,线上出现了白屏,无法显示
原因
这是因为浏览器缓存了之前的html,用户访问的还是之前的html,但是由于我们重新打包更新了服务器的资源,那么之前的html上引用的资源已经不存在了,所以页面就无法显示出来了。
解决思路
1. 手动刷新。懂的都都懂,用户自己看到屏幕白茫茫一片,肯定以为网络不好,多刷新几次就出来了。
2. 在html加上 no-cache 等等 meta标签,然后服务器ngix也加伤 no-cache 等不缓存的代码,网上搜一搜:vue打包缓存白屏,会有好多,这里就不多说了,主要是我加了这些东西后跟没加的效果一样,并不能解决,还有可能是项目是放在别人的cdn上,改不了服务器,可能也不会起作用。
3. 代码刷新。通过测试我们可以看到,当出现白屏时,刷新可以使页面恢复正常,那是刷新时绕过了缓存,有兴趣的朋友可以去了解这方面的知识。所以,我们只需要在资源加载出错的时候让页面重新刷新,那么问题就可以解决了。
代码刷新处理方法
1. 监听资源加载。在页面加载完成时,使用window自带方法,监听资源加载失败error时,查找失败的资源是否是我们vue项目的资源,只要匹配一个即可通知我们调用刷新页面的方法。
汗颜,我是想监听失败的js、css,奈何一直无法监听到,所以放弃了,有成功的朋友可以交流交流。
2. 在项目main.js内定义一个全局变量
window.my_isLoad = 1
然后我们在index.html内写上监听的方法,此处需注意,如果使用window.onload,那要确保你项目其他地方没有使用这个方法,不然会失效,因为window.onload只能执行一次,多个时只执行最后一个。
或者引入jquery,使用jquery的ready方法,该方法可以多次调用,并且执行的时间节点比onload靠前,节省时间
先在index.html引入jquery
$(document).ready( function(){ if(!window.my_isLoad) { // 这里可供自己测试查看,上线时可去掉,或自己做替他交互也可以,比如在页面上给什么提示信息、按钮 var paydiv = document.createElement('div') paydiv.innerHTML = '资源加载失败,我要刷新了' document.body.appendChild(paydiv) // setTimeout(()=>{ document.body.removeChild(paydiv) window.location.reload(true) },10000) // 这个延迟时间可自己控制,页面加载出错多久后刷新页面 } } )
上面使用的是通过在main.js内新增变量去判断,由于我司的页面有很多嵌入app的混合项目,在某个ios内出现了刷新页面时,缓存了之前window的变量,导致判断不准确,所以又想了一个不使用window变量的方法。
思路就是在App.vue 内创建一个元素,然后同样在index.html判断页面是否存在这个元素
在mounted生命周期里执行这个方法,添加一个元素,我们在index.html内通过id判断这个元素
this.$nextTick(()=>{ (function(){ var appDom = document.getElementById('app') //这里的app是我们vue项目的app var checkDom = document.createElement('span') checkDom.setAttribute('id', 'my-check-load-dom') //这里的id是我们需要判断的 checkDom.style.display = 'none' appDom.appendChild(checkDom) })() })
$(document).ready( function(){ var myLoadDom = document.getElementById('my-check-load-dom') if(!myLoadDom) { var paydiv = document.createElement('div') paydiv.innerHTML = '资源加载失败,我要刷新了' document.body.appendChild(paydiv) setTimeout(()=>{ document.body.removeChild(paydiv) window.location.reload(true) },10000) } } )
至此,在资源加载时候,页面可以自动刷新,从而答案重新获取资源,解决白屏的问题。
若是嵌入app的混合项目,需要app的webview支持我们浏览器的刷新方法,这点可以自己去测试,若不支持的话,可以去跟公司的app大佬沟通,有些webview默认不支持,需要他们写方法支持。
总结
以上为个人经验,希望能给大家一个参考,也希望大家多多支持脚本之家。