技术总监:尽快解决这个ios11白屏问题

事情是这样的,上上上上周有个用户用手机访问我们的页面白屏了,客服还专门拉了沟通群。前端组长对我说,这个问题你来协助解决一下。说干就干,但这个问题有点麻烦,需要点时间才能解决。作为一个成熟的程序员,先让客服同学安抚一下用户,毕竟咱们公司以客户为中心嘛,另外也预留一些时间解决问题。万万没想到,我们正在加急处理问题,客户给技术总监打电话了。好家伙,总监发话了,这个问题很严重,要尽快解决。那咋整,继续加急处理呗。
从客服那得知,用户的手机是ios11系统,其他手机并不会出现白屏问题,初步判断是兼容性问题。要系统的分析白屏问题,先梳理一下整个页面的访问链路,也就是面试经常会问到的一个问题:从输入URL到页面显示中间发生了什么?请看下图。

1why:为什么会白屏呢?

首先,只有ios11才会出现,说明不是没有返回html,从现象来看可以证实,页面上显示了标题,只是没有内容。通过抓包发现,确实有返回html。基本可以肯定,问题出现在浏览器这一层,也就是上图的红色部分。

2why:为什么没有内容?

抓包发现有返回html,也返回了入口js,也就是app.xxx.js和chunk-vendors.xxx.js。有js,但没内容,那有两种可能:

  1. 入口js没有执行
  2. 入口js执行报错了,导致后面渲染页面的代码没有执行

那看看日志系统上面有没有上报错误信息。查了一下发现,没有任何错误信息。那有可能是上报系统没有上报。好吧,只能用vConsole(一款移动端h5调试神器)大法了。使用很简单,直接在html的head中加入以下代码(注意:一定要确保在入口js之前执行,否则可能捕获不到错误):

<script src="https://unpkg.com/vconsole@3.3.14/dist/vconsole.min.js"></script>
<script>
  var vConsole = new window.VConsole();
</script>

用ios11手机打开测试页面,发现链链vConsole按钮并没有出现。难道连vConsole也有兼容问题?经过几次测试,换了低版本的vConsole后,终于可以调试了。
image.png
刷新页面,打开vConsole,找不到任何报错的具体信息,只有简单的Script error。但到这一步确定了是js报错导致白屏,那下一步就要想办法获取报错的具体信息。
image.png

3why:为什么只显示Script error?

原因其实很简单,js、css等静态资源是放在CND上的,静态资源域名和页面域名不同,存在跨域问题。了解过跨域的同学都知道,由于浏览器安全策略限制,跨域脚本报错时,无法直接获取错误的详细信息,只能得到一个Script Error。
找到了原因,解决问题就简单了,配置两样东西:

  1. 配置响应头:Access-Control-Allow-Origin
  2. 给script标签增加crossorigin属性,白屏页面使用的是vue框架,只要在vue.config.js中增加crossorigin:""即可

配置完毕,再看看报错信息,发现了入口js的getCurriculumTime方法报错了。上面我们判断到是兼容问题,是否这个方法有兼容问题呢?根据报错信息搜索入口js,竟然是一个async方法。
image.png
也就是说,es6语法并没有转译成es5。但.browserslistrc已经配置了ios >= 8,为啥没有转译?

4why:为什么es6语法没有转译成es5?

在vue.config.js中有一个transpileDependencies配置,Vue Cli官方文档是这样解释的:

Type: boolean | Array<string | RegExp>
Default: false
默认情况下 babel-loader 会忽略所有 node_modules 中的文件。你可以启用本选项,以避免构建后的代码中出现未转译的第三方依赖。不过,对所有的依赖都进行转译可能会降低构建速度。如果对构建性能有所顾虑,你可以只转译部分特定的依赖:给本选项传一个数组,列出需要转译的第三方包包名或正则表达式即可。

经排查发现,getCurriculumTime确实是node_modules下一个依赖里的方法。白屏页面使用了这个依赖里的几个vue组件。原因找到了,那就好解决了,直接依赖包的包名放到transpileDependencies数组中,类似下面这样:

transpileDependencies:['@xxx/xxx']

这下以为可以把问题解决了,差点激动得去报告组长。慢着,作为一个成熟的程序员,咱们先自测一下。
好家伙,并没什么ruan用,白屏还是白屏,报错还是那个报错。莫非,transpileDependencies配置没生效,果然一搜编译后的代码,async等es6语法还在。
再看transpileDependencies配置,可以是boolean,可以是字符串、正则数组,反复试了true、正则都没有生效。用户又一直在问进展。不行,得先暂停深挖原因,得先找个简单方法解决了。既然默认不转译node_modules下的包,那就直接引用组件的vue代码,试一下果然生效了。好的,问题解决了,喝口水摸下鱼歇歇脚。

5why:为什么transpileDependencies配置没有生效?

虽然临时解决白屏问题,但是工程引了很多依赖,只要存在一个依赖没有转译成es5,就有可能出问题,像一颗不定时炸弹,一爆炸就让人熬夜加班掉头发。作为一个成熟的程序员,咱们得彻底解决问题。为了找到transpileDependencies配置没生效的问题,翻一下源码。vs code全局搜node_modueles/@vue文件夹,找到了蛛丝马迹。

// @vue/cli-plugin-babel\index.js
function genTranspileDepRegex (transpileDependencies) {
  const deps = transpileDependencies.map(dep => {
    if (typeof dep === 'string') {
      const depPath = path.join('node_modules', dep, '/')
      return isWindows
        ? depPath.replace(/\\/g, '\\\\') // double escape for windows style path
        : depPath
    } else if (dep instanceof RegExp) {
      return dep.source
    }
  })
  return deps.length ? new RegExp(deps.join('|')) : null
}

这段代码大家都看得懂,就不解释了,看看使用这个方法的地方:
image.png
两段代码的意思就是,在transpileDependencies配置里的依赖会进行转译,官方文档并没有骗人。问题是用我的电脑编译会转译,在服务器编译就不会转译。百思不得其解,搜一下看看有没有人遇到过。搜了很久,都说没有找到根本原因,曲线救国解决问题。不过有个哥们说不能用cnpm安装依赖,好家伙,我电脑上用的是npm,服务器上用的是cnpm。

6why:为什么cnpm安装依赖就不转译?

查了cnpm和npm的区别,都在说cnpm是国内源,没有其他有用消息。但从问题来看,cnpm和npm还有其他区别。为了找到根本原因,在源码里加点日志,调试一下。
image.png

//vue.config.js 转译node_modules下所有@xiaoe的依赖
transpileDependencies: [/[/\\]node_modules[/\\]@xiaoe/]

来看看结果:

  1. npm:@xiaoe依赖会正常转译

image.png

  1. cnpm:所有@xiaoe都没有转译

image.png
对比很容易发现,cnpm安装的包带上_字符,路径变了,正则匹配不了,所以通过cnpm安装的包都不会转译。
image.png

解决办法

找到了根本原因,问题迎刃而解。

方式一:只要将正则表达式改成可以匹配cnpm安装的依赖路径即可。

// 如果要匹配其他包,将@xiaoe改成其他包名即可
transpileDependencies: [/[/\\]node_modules[/\\]_?@xiaoe/]

方式二:使用npm安装依赖

方式三:将正则匹配node_modules即可,但是这会导致编译速度变慢,需要根据实际情况选择适合的方式。

transpileDependencies: [/[/\\]node_modules[/\\]/]

总结

上面使用了6w的思维方式彻底解决白屏问题,可能过程有点繁琐。实际操作过程中比文章描述还曲折,但基本算是彻底整明白了。
另外有一点想和大家分享的是,平时工作中由于比较忙,往往把问题解决就不继续深究根本原因了,这对于技术人来说并不是什么好事。刨根究底,虽然比较花时间,但可以提升看问题的深度和彻底解决问题的能力。
最后,整理这篇文章花了一天的时间,如果对大家有帮助,不妨来个一键三连。如果觉得有什么地方写的不对或者不详细的地方也欢迎在评论区讨论,我会花时间回复大家的,哈哈哈。

36 声望
0 粉丝
0 条评论
推荐阅读
单文件组件下的vue,可以擦出怎样的火花
与时俱进吧,看着 vue3 和 vite,虽然不会用,但还是心痒痒,然后就把原先基于 vue@2 的实现做了重构。不周之处,大家见谅!下面关于过期的内容,我就用删除线标记了。

leftstick64阅读 45.1k评论 18

从零搭建 Node.js 企业级 Web 服务器(零):静态服务
过去 5 年,我前后在菜鸟网络和蚂蚁金服做开发工作,一方面支撑业务团队开发各类业务系统,另一方面在自己的技术团队做基础技术建设。期间借着 Node.js 的锋芒做了不少 Web 系统,有的至今生气蓬勃、有的早已夭折...

乌柏木148阅读 12.1k评论 10

JavaScript有用的代码片段和trick
平时工作过程中可以用到的实用代码集棉。判断对象否为空 {代码...} 浮点数取整 {代码...} 注意:前三种方法只适用于32个位整数,对于负数的处理上和Math.floor是不同的。 {代码...} 生成6位数字验证码 {代码...} ...

jenemy46阅读 5.9k评论 12

从零搭建 Node.js 企业级 Web 服务器(十五):总结与展望
总结截止到本章 “从零搭建 Node.js 企业级 Web 服务器” 主题共计 16 章内容就更新完毕了,回顾第零章曾写道:搭建一个 Node.js 企业级 Web 服务器并非难事,只是必须做好几个关键事项这几件必须做好的关键事项就...

乌柏木66阅读 6.1k评论 16

再也不学AJAX了!(二)使用AJAX ① XMLHttpRequest
「再也不学 AJAX 了」是一个以 AJAX 为主题的系列文章,希望读者通过阅读本系列文章,能够对 AJAX 技术有更加深入的认识和理解,从此能够再也不用专门学习 AJAX。本篇文章为该系列的第二篇,最近更新于 2023 年 1...

libinfs39阅读 6.3k评论 12

封面图
从零搭建 Node.js 企业级 Web 服务器(一):接口与分层
分层规范从本章起,正式进入企业级 Web 服务器核心内容。通常,一块完整的业务逻辑是由视图层、控制层、服务层、模型层共同定义与实现的,如下图:从上至下,抽象层次逐渐加深。从下至上,业务细节逐渐清晰。视图...

乌柏木43阅读 7.3k评论 6

从零搭建 Node.js 企业级 Web 服务器(二):校验
校验就是对输入条件的约束,避免无效的输入引起异常。Web 系统的用户输入主要为编辑与提交各类表单,一方面校验要做在编辑表单字段与提交的时候,另一方面接收表单的接口也要做足校验行为,通过前后端共同控制输...

乌柏木33阅读 6.1k评论 9

36 声望
0 粉丝
宣传栏