微信H5页面加载失败问题排查

微信H5页面加载失败问题排查

背景

公司有个H5游戏应用,所有游戏通过一个H5中转页统一处理参数,然后根据类型,跳转到不同游戏

H5页面内嵌在小程序web-view中,通过小程序进入

问题描述

有客户反馈H5游戏页面无法成功加载,页面白屏,无任何反应

测试同学在灰度、测试环境均无法复现

小程序日志无报错,H5日志无该用户记录

有一位运营同学手机可以复现,机型为iphoneXr

问题排查定位

找报错信息

页面白屏,往往是有js报错,或者是逻辑不对

我推荐的顺序是,先看页面是否存在报错,再去排除代码逻辑问题

报错往往是直观的,通过报错能迅速定位问题

我直接引入了eruda,这是一个移动端的控制台,在页面入口文件中index.html,参考下方代码

xml 复制代码
<!-- 手机控制台 -->
<script type="text/javascript" src="https://cdn.jsdelivr.net/npm/eruda"></script>
<script>eruda.init();</script>

引入后,在运营同学手机上复现问题,可以看到控制台报错

报错信息如下

rust 复制代码
Unexpected token '='. Expected an opening '(' before a method's parameter list .

想办法在本地复现问题

我让这位运营同学在我本地微信开发者工具扫了码,发现我本地可以正常访问。

虽然问题没能复现,但是排除了是这个同学的会员有问题,可能是运行环境导致

我想知道这个同学的运行环境,有两种方法

运行环境

  • 第一种是可以让这个同学在上方报错的控制台中,输入navigator.userAgent,查看运行环境(但由于这个同学在上海我在武汉,这个同学又不是技术,我采取了第二种方法)
  • 第二种是找一个在线获取userAgent的链接,我用的是https://useragent.buyaocha.com/,发到这位同学的微信上,让他点链接后截图

上方蓝圈是我的设备iphone 13 Pro,下方是这位同学的iphone xr。我的可以正常访问,他的白屏。

我对比了一下UA信息,发现只有ios版本有差异,我的是17.1.1,他的是13.6,浏览器内核都是一样的。

我觉得可以排除是内核问题了,从ios版本差异入手排查

查阅资料,我了解到,Safari浏览器的版本,和ios系统主版本是一致的

资料链接:developer.apple.com/documentati...

我现在尝试在本地复现

云模拟机

根据信息,我需要模拟 ios 13.6 系统,模拟器有两种

  • lambdatest

    • 可能需要科学上网
    • 有3次1分钟的免费模拟器测试机会
  • WeTest

    • 腾讯出品
    • 新用户绑定身份证送30分钟测试时间

我使用 ios 13.6真机模拟,复现了问题

问题定位

复现了问题,开始排查

我将报错丢到google里,找到了如下资料

这是由于在Safari 13 中,不支持public field declarations, 也叫做公有字段声明

后来我也佐证了这一点

我通过class关键字,在产物中发现了

而这,正是基于lit的游戏组件

问题找到了

问题解决

将组件库的代码转换成es5,发包

更新组件版本问题就解决了,此时,es5转换后的代码如下图

影响范围

通过 can I use,我们可以发现从15.7之后才被支持,也就是说,ios15以下版本机型会受影响,ios15的默认机型是iphone13

总结

要考虑到代码的兼容性,无论使用babel还是使用polyfill

相关推荐
范文杰2 小时前
AI 时代如何更高效开发前端组件?21st.dev 给了一种答案
前端·ai编程
拉不动的猪2 小时前
刷刷题50(常见的js数据通信与渲染问题)
前端·javascript·面试
拉不动的猪2 小时前
JS多线程Webworks中的几种实战场景演示
前端·javascript·面试
FreeCultureBoy2 小时前
macOS 命令行 原生挂载 webdav 方法
前端
uhakadotcom3 小时前
Astro 框架:快速构建内容驱动型网站的利器
前端·javascript·面试
uhakadotcom3 小时前
了解Nest.js和Next.js:如何选择合适的框架
前端·javascript·面试
uhakadotcom3 小时前
React与Next.js:基础知识及应用场景
前端·面试·github
uhakadotcom3 小时前
Remix 框架:性能与易用性的完美结合
前端·javascript·面试
uhakadotcom3 小时前
Node.js 包管理器:npm vs pnpm
前端·javascript·面试
LaoZhangAI4 小时前
2025最全GPT-4o图像生成API指南:官方接口配置+15个实用提示词【保姆级教程】
前端