关于vite项目中可能存在的前端资源加载报错

直接上事故现场:

关键字:LINK load fail,preloadError,vite,preload

vite官方文档

构建生产版本 | Vite 官方中文文档

事故产生原因分析

这个报错大量发生在项目重新部署后,按照官方的说法是缓存问题

为了解决缓存问题,前端做了什么?

产物名称加hash

防止重新部署后,因为浏览器缓存了部分之前版本的文件,用户端混淆着新旧版本的代码,导致项目出错,当然这个优化这个vite已经默认帮我们做了

产物增量部署

防止重新部署后,用户加载的html还在历史版本,假如部署时删掉历史版本的产物,在历史版本的用户可能会因加载不到旧版本的资源文件报错

<meta http-equiv="cache-control" />

html 复制代码
<meta http-equiv="cache-control" content="no-cache, no-store, must-revalidate" />

在入口HTML文件中,可以配置这个meta标签,来告知浏览器不要缓存HTML文件

划重点

然而,通常来说服务端返回的response header中的缓存策略可能优先级更高!所以......最好在Nginx中配置响应头,而不是在HTML中配置

ps:关于这块内容,可以自行百度浏览器中的强缓存和协商缓存学习,(多年背的面试题终于派上用场了)

域名加版本号/时间戳后缀

bash 复制代码
<web-view
  :src="`https://www.baidu.com?__v=${versionCode}&__t=${dayjs().unix()}`"
/>

(别问,问就是write once、debug anywhere 的uniapp开发)

and more

可能还有疏漏的地方......

做的还不够吗?

c端应用的运行环境确实复杂,可能也有笔者疏漏的地方,总之还是按照vite的文档加上

js 复制代码
window.addEventListener('vite:preloadError', (event) => {
  window.location.reload() // 例如,刷新页面
})

最后别忘了

js 复制代码
window.removeEventListener('vite:preloadError', callBack)
相关推荐
linweidong15 分钟前
C++ 模块化编程(Modules)在大规模系统中的实践难点?
linux·前端·c++
leobertlan4 小时前
2025年终总结
前端·后端·程序员
子兮曰4 小时前
OpenClaw架构揭秘:178k stars的个人AI助手如何用Gateway模式统一控制12+通讯频道
前端·javascript·github
百锦再5 小时前
Reactive编程入门:Project Reactor 深度指南
前端·javascript·python·react.js·django·前端框架·reactjs
莲华君5 小时前
React快速上手:从零到项目实战
前端·reactjs教程
百锦再5 小时前
React编程高级主题:测试代码
android·前端·javascript·react.js·前端框架·reactjs
易安说AI5 小时前
Ralph Loop 让Claude无止尽干活的牛马...
前端·后端
失忆爆表症7 小时前
05_UI 组件库集成指南:Shadcn/ui + Tailwind CSS v4
前端·css·ui
小迷糊的学习记录7 小时前
Vuex 与 pinia
前端·javascript·vue.js
发现一只大呆瓜7 小时前
前端性能优化:图片懒加载的三种手写方案
前端·javascript·面试