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了一些module,push方法被hook了,本质是会缓存一些moduleId。

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

5. 后记

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

相关推荐
Autumn_ing1 小时前
Design.md生成UI怎么验收?举例运营后台的颜色、状态和数据核对
前端·ui·ai·设计系统·paico·ai生成ui·design.md
keyipatience2 小时前
JavaScript学习(1)书写位置,变量、数据类型、运算符
开发语言·前端·javascript·css·学习
朱涛的自习室2 小时前
我给 Gemini 4 和 DeepSeek 搞了套「末位淘汰」,AI 干活会更猛吗?(Day 3)
android·前端·后端
java1234_小锋5 小时前
【技术专题】HTML5 网页技术 - HTML5简介 & HTML5 文档结构
前端·html·html5
鶴哥只手遮天5 小时前
Vue 3 核心源码深度剖析系列(v3.5.44)-第 1 章 项目全景:monorepo 架构与工程化体系
前端·vue.js·开源
流星。。方5 小时前
小团队官网SEO落地:前端语义化与静态生成的工程实践
前端·状态模式
用户530429765795 小时前
盘点危化品搬运诊断的6类工具与自处理边界判断
前端
curtain5 小时前
从古法编程到 Agent:我入行这两年,AI 改变了什么
前端·openai
zyfts6 小时前
10分钟自制Codex钉钉通知Skill:AI干完活自动钉钉提醒你
前端
大孜然6 小时前
孜然QQ频道自动化程序机器人配置教程
前端