新手上路 · 网址打包
网址打包后一片白屏:五步排查,从最容易的开始

填了网址、选好图标、打完包,打开却是一片白。这不是打包失败,而是页面在壳里没能正常加载。白屏的原因就那么几种,按这五步走,多数能在一刻钟内解决。

白屏的排查顺序很重要:先排除网址本身,再看协议与证书,再看权限,再看内核兼容,最后才怀疑页面自身。本文给出一条五步排查线,每步都有明确的验证动作,并附上长期稳定的几条设置建议。

第一步:网址在浏览器里能打开吗

用手机浏览器打开同一个网址,注意是手机网络而不是电脑。打不开就是网址、域名解析或服务器的问题,跟壳无关。这一步常被跳过,结果在打包设置里折腾半天。

第二步:http 还是 https,证书是否可信

壳默认会拦截不受信任的证书。如果站点是自签证书或者证书过期,页面会被静默拦下,表现出来就是白屏。换成 https 正规证书,或者在测试阶段明确允许不安全连接(正式环境不要开)。

第三步:权限有没有给

壳应用需要联网权限;如果页面要拍照、上传、定位,还需要对应的运行时权限。老版本系统上权限弹窗可能不出现,直接判定为拒绝,页面里的功能就静默失败。检查应用权限列表,缺哪个补哪个。

第四步:内核兼容

老站点用了 frameset、document.write、老式 JS 库,新内核可能直接不渲染。反过来,新站点用了较新的 CSS/JS 特性,老内核白屏。换一个内核重新打包,用同一个网址对比,能立刻判断是不是内核问题。

第五步:页面自己在报错

打开壳的调试日志或者远程调试,看控制台有没有报错。常见是接口跨域被拦、资源 404、或者首屏依赖的 JS 加载失败。这类问题必须改页面,壳解决不了。

稳定下来的几条设置建议

  • 固定首页地址,不要带随机参数
  • 开启缓存但设过期时间,避免永久缓存旧页面
  • 准备一个本地兜底页,断网时不至于全白
  • 把外部链接(支付、地图)允许唤起,否则点了没反应
  • 返回键行为明确:回首页还是退出,别让它随机
一句话记住

白屏不是壳的锅就是页面的锅。先浏览器验证,再证书、权限、内核,最后看控制台日志,五步之内基本能定位。

想动手试一遍

三个版本任选:经典修改版 适合精修与反编译研究,智改工坊电脑版 适合批量与口述改包,智改工坊安卓版 适合手机现场改包。

同栏目其他文章:新手上路栏目列表;也看看反编译研究。