qq小程序组件加载失败分析

1. 问题

qq小程序(基于uni-app)使用JS分发和组件分发插件后,有些页面会白屏,打开调试器,会看到下面的报错:

意思是找不到这个页面,然后列举了一系列的有效的组件。

这个问题只在qq小程序的真机上出现,在qq小程序开发者工具、微信小程序都没有。

2. 原因

找了一圈原因,最后发现是执行顺序不同导致的原因。qq小程序真机上,并不是先运行Page页面,而是先执行每个组件,或者说校验每个合理的组件,而其他环境,都是先执行Page下的js

Page下的js会加载此分包下的vendor.js,也就是每个页面下的js第一句都是下面的代码:

js 复制代码
require('./common/vendor.js');(global["webpackJsonp"]=global["webpackJsonp"]||[]).push()

这会加载分包中的module,注册一些moduleId。而qq小程序真机环境先执行了组件,此时如果某些moduleId还没注册的话,就会报错。

3. 实验

我们检验一下这个结论,在组件和页面对应的JS中分别打印一句话,看看执行顺序。

在qq小程序真机下:

在qq小程序开发者工具下:

上面的create page对应页面,press switch对应组件,可以看到qq小程序真机与开发者工具,对组件和页面的加载顺序确实不同。

4. 解决

如何解决这个问题呢?既然组件需要这个moduleId,那就提前加载好就可以了。这里写了个插件,自动引入分包所在的vendor

会不会有副作用呢?不会的,这里要了解下webpack运行时原理。vendor.js只是往global["webpackJsonp"]push了一些modulepush方法被hook了,本质是会缓存一些moduleId

另外,那些并非插件移动的组件为什么没问题呢,因为它们和Page下的js一样,第一句都引用了分包中的vendor.js

5. 后记

虽然是个小问题,定位却花了不少时间,因为微信小程序没问题,所以没往执行顺序不同那方面想,期间猜想问题原因可能是moduleId找错了之类的。

相关推荐
今天AI了吗4 分钟前
2026年三大AI桌面智能体横评:Codex vs Hermes vs WorkBuddy
大数据·前端·css·人工智能·架构
kill52217 分钟前
interface vs type:到底该用哪个
前端
敲代码的嘎仔25 分钟前
从零实现视频续播 + 学习进度统计:前端心跳、条件更新、GROUP BY 统计全链路拆解
java·前端·数据库·学习·面试·职场和发展·音视频
做萤石二次开发的哈哈26 分钟前
海康移动交通四款设备技能接入实战:布控球+取证终端+测速仪+出入口终端,Web/App/小程序移动交通应用快速生成
前端·物联网·萤石开放平台·蓝海aiot一站式工作台·aiot开发·移动交通
IT_陈寒40 分钟前
我TM竟然被Java的空指针坑了第三次!
前端·人工智能·后端
xcLeigh44 分钟前
AI 编程学习路线图:一份覆盖前端、后端、全栈的系统学习计划
前端·人工智能·学习
linux_cfan1 小时前
HTML5 视频交互标注实践:用开源播放器 ZWPlayer 实现热区、测验与分支节点(附接入代码)
前端·javascript·音视频
小羊没烦恼!1 小时前
Office文件的奥秘——.NET平台下不借助Office实现Word、Powerpoint等文件的解析(完)
java·大数据·前端·网络·word·powerpoint·.net
风骏时光牛马1 小时前
AI提示词工程:高效构建精准指令的方法论
前端
葡萄城技术团队1 小时前
一个好的 BI Dashboard 到底应该怎么设计?
前端