1、问题

前一段时间发布新版本之后,第二天有一些客户反馈:在微信端打开出现白屏现象。经过测试之后发现,刷新一下就OK了。
白屏主要集中在发版线上后的一段时间
主要以ios居多,安卓偶现,刷新就好了.

2、原因

微信公众号H5白屏现象很多,一部分是浏览器和app自身的原因,一部分是开发异常问题。
如果是开发的bug,多半是js报错,阻断了html的渲染,这种白屏刷新结果仍然是白屏。
还有一种白屏是公众号菜单进入首页或者初次点击链接进入首页白屏,但是刷新又好了。
这种白屏原因可能有很多:

  • 手机本身网络问题,wifi和4G的弱网和异常,换个wifi或者重启路由就可以了.
  • 因为内存不足或者微信缓存造成的白屏,偶现,但是基于手机性能,刷新就好了,如首页图片加载过多过大,html文件过大,长时间未清理系统缓存.
  • 系统抽风的灵异现象,微信大面积白屏,长时间未关机,未重启微信等

这次可能的原因

分析白屏原因,应该是用户访问的index.html并不是最新的, 而是微信缓存的旧版的index.html 但是本地的JS缓存过期了,加载旧版JS的时候404了。

微信客户端及微信浏览器下比较特殊,这个bug一样的存在居然把入口文件html给缓存下来了,这就意味着通过版本号和hash号的形式避免缓存的方案失效了。同时html的meta设置依旧没能生效。
标准的浏览器是不会缓存html文件的。

经常使用vue作为开发框架的开发者都知道,build打包后,所生成的css/js的文件名中间会夹杂哈希值,以此来避免缓存问题。但是由于入口文件index.html的名字每次打包后不改变,并且也不能乱变,就导致了index.html在用户端仍然会被缓存下来。那么在服务端更新包之后,由于旧的文件被删除,而index.html所链接的路径依然是旧文件路径,因此会找不到文件,从而白屏。

3、过渡方案

把前一次的文件都保留下来,不删除,这样即使缓存了index.html,请求之前的js~文件,也能找到对应的文件,不会出现白屏的状况,用户体验大幅提升,同时接口向下兼容。

4、解决方案

4.1 配置nginx服务器

更改服务器配置,强制不缓存入口文件,其他静态正常缓存,比如在nginx中对静态部分如下

location / {
    root   /mnt/dat1/test/tes-app;
    index  index.html index.htm;
    try_files $uri $uri/ /index.html;
    #### kill cache
    add_header Last-Modified $date_gmt;
    add_header Cache-Control 'no-store, no-cache, must-revalidate, proxy-revalidate, max-age=0';
    if_modified_since off;
    expires off;
    etag off;
}

location ~* ^.+\.(jpg|jpeg|gif|png|ico|css|js)$ {
    root   /mnt/dat1/test/tes-app;
    access_log off;
    expires 30d;
}  

在这里我们需要注意的是,我们刚刚的配置,只是对html强制不缓存,但是对于我们index.html内的资源,我们没有去做处理,原因就是前面说的,index内的引用资源如果改变,都会生成新的文件名称,因此我们不需要担心它的缓存问题。我们只要保证index.html的内容是最新的就OK了。

注意:此方法的好处是,每次访问微信公众号首页都会从服务器读取新的静态文件,所以每次版本更新后打包到服务器就是即时更新,当然同时也带来了一定的弊端,如果整个项目打包下来的静态文件比较大时,每次加载文件就会比较慢,实际上也是一种不得已的方式解决微信公众号带来的缓存问题,按需取舍吧

4.2 前端打包保留两个版本

考虑每次发版把前一次的文件都保存起来,这样即使调用缓存,请求之前的js~文件,也能找到对应的文件,不会出现白屏的状况,用户体验大幅提升,同时接口向下兼容。
打包后的文件格式如下:
在这里插入图片描述
具体操作:将static改为携带版本号(从1开始递增的证书)---------每次发版webpack导出文件为staticN(static1,static2等样式)---------删除static(N-2)
代码操作:在config/index.js里面加上每次发版的版本号,还有webpack的导出地址由static改为static+版本号。

'use strict';
// Template version: 1.3.1
// see http://vuejs-templates.github.io/webpack for documentation.
 
var path = require('path');
const version = 2;
module.exports = {
  version:version,
  dev: {
    // Paths
    assetsSubDirectory: 'static' + version,
    assetsPublicPath: '/',
    proxyTable: {},
 
    // Various Dev Server settings
    // host: 'localhost', // can be overwritten by process.env.HOST
    host: '0.0.0.0',
    port: 6060, // can be overwritten by process.env.PORT, if port is in use, a free one will be determined
    autoOpenBrowser: false,
    errorOverlay: true,
    notifyOnErrors: true,
    poll: false, // https://webpack.js.org/configuration/dev-server/#devserver-watchoptions-
 
    // Use Eslint Loader?
    // If true, your code will be linted during bundling and
    // linting errors and warnings will be shown in the console.
    useEslint: false,
    // If true, eslint errors and warnings will also be shown in the error overlay
    // in the browser.
    showEslintErrorsInOverlay: false,
 
    /**
     * Source Maps
     */
 
    // https://webpack.js.org/configuration/devtool/#development
    devtool: 'cheap-module-eval-source-map',
 
    // If you have problems debugging vue-files in devtools,
    // set this to false - it *may* help
    // https://vue-loader.vuejs.org/en/options.html#cachebusting
    cacheBusting: true,
 
    cssSourceMap: true,
  },
 
  build: {
    // Template for index.html
    index: path.resolve(__dirname, '../dist/index.html'),
 
    // Paths
    assetsRoot: path.resolve(__dirname, '../dist'),
    assetsSubDirectory: 'static'+ version,
    // assetsPublicPath: './',
    assetsPublicPath: '/',
 
    /**
     * Source Maps
     */
 
    productionSourceMap: false,
    // https://webpack.js.org/configuration/devtool/#production
    devtool: '#source-map',
 
    // Gzip off by default as many popular static hosts such as
    // Surge or Netlify already gzip all static assets for you.
    // Before setting to `true`, make sure to:
    // npm install --save-dev compression-webpack-plugin
    productionGzip: false,
    productionGzipExtensions: ['js', 'css'],
 
    // Run the build command with an extra argument to
    // View the bundle analyzer report after build finishes:
    // `npm run build --report`
    // Set to `true` or `false` to always turn it on or off
    bundleAnalyzerReport: process.env.npm_config_report,
  },
  checkout: {
    productionSourceMap: true,
  },
};

接下来就是删除static(N-2)了,在build/build.js文件
注意这个插件rimarf,本用于删除static文件夹

var rm = require('rimraf');
 
 
rm(path.join(config.build.assetsRoot, config.build.assetsSubDirectory), err => {
  if (err) throw err

我们将之加上版本号

rm(path.join(config.build.assetsRoot,'static'+(config.version-2)), err => {

这样每次打包之后都会保留两个版本的static文件夹,解决白屏。

参考文章

vue+webpack打包发布到线上后微信公众号H5部分打开白屏,刷新又好了
微信公众号Vue单页应用版本更新后的缓存问题
微信浏览器内单页应用缓存问题解决方案实践
解决前端每次发版白屏问题的新思路(修改webpack保存上一次发版文件)

Logo

华为开发者空间,是为全球开发者打造的专属开发空间,汇聚了华为优质开发资源及工具,致力于让每一位开发者拥有一台云主机,基于华为根生态开发、创新。

更多推荐