管理页白屏:浏览器能力排查清单
白屏 = 浏览器不支持,不是功能坏了
整个管理界面是一个 WebAssembly 应用。浏览器不支持 WebAssembly 时,页面就是纯白——不是「部分功能用不了」,是整个界面出不来。所以白屏第一件事不是怀疑软件,是怀疑浏览器。
一定能行的组合
- 电脑:较新版本的 Edge、Chrome、Safari、Firefox
- 手机平板:主流现代浏览器
一定不行的组合
| 设备 | 为什么不行 |
|---|---|
| Internet Explorer | 无 WebAssembly |
| 电视、机顶盒自带浏览器 | 精简内核,多半不支持或残缺 |
| 电子书、车机内置浏览器 | 同上 |
排查顺序
- 换浏览器:同一台电脑换 Edge 或 Chrome 试,最快验证
- 无痕模式:排除扩展与缓存干扰(Linux 上界面卡顿的已知解法也是无痕模式)
- 换设备打开:管理页跑在服务端,手机开界面、电脑开界面完全等价——设备不在现场时尤其有用
- 确认地址与端口:本机是 localhost 加 19798,别的设备是主机 IP 加 19798,端口体系见浏览器管理页功能导览
换道方案
- 打不开管理页但服务在跑 → 装对应平台的应用(手机、电视、Windows 桌面版自带界面),见核心服务与应用两条产品线到底怎么选
- 头显浏览器打不开 → 用手机完成配置后回头显播放,见VR 头显里看网盘影片的沉浸播放
别混淆的另一种「白」
管理页能打开、但文件列表空白——这不是浏览器问题,去查网盘授权是否失效、网络是否可达,见添加第一个网盘账户的授权步骤与网络报错要在跑服务的那台机器上查。