应用重载或显示空白屏幕
大多数重载或空白屏幕问题在刷新并清除缓存后不到 2 分钟即可解决。
本指南可帮助你解决 AVA 持续重载、显示空白屏幕或无法启动入住流程的问题。 自助机可能会在更新后重载一次,以便加载最新的软件包。 AVA 加载由 PMS 支持的入住设置时,也可能会短暂等待。
快速参考
| 你看到的情况 | 原因 | 操作 |
|---|---|---|
| 入住页面显示 Starting check-in... | AVA 正在加载安全启动设置或由 PMS 支持的设置 | 短暂等待或重试 |
| 显示“Unable to start check-in” | 安全启动未能完成 | 检查连接并重试 |
| 登录后显示空白屏幕 | 浏览器仍在使用旧文件 | 刷新并重新打开应用 |
| 登录后或更新后页面重载一次 | 应用正在更新为新文件 | 等待重载完成 |
| 更改翻译后语言选择器持续重载 | 应用正在从翻译更新中恢复 | 等待其稳定下来 |
| 返回标签页后短暂刷新 | AVA 正在执行后台会话检查 | 等待几秒 |
| 选定的页面没有立即打开 | AVA 正在加载该页面的文件 | 等待后再刷新 |
| 左侧面板显示“Navigation unavailable” | 侧边栏渲染失败 | 重试侧边栏 |
| 按钮没有响应 | 页面部分内容未加载 | 刷新并清除缓存 |
快速恢复步骤
- 等待 10 秒,查看应用是否会自行重载。
- 点击浏览器的 Refresh 按钮。
- 如果屏幕仍然空白,请关闭标签页,然后重新打开应用。
- 如果问题重复出现,请等待 1 分钟后重试。
✅ 大多数情况下,完成这些步骤后应用会正常加载。
详细修复步骤
步骤 1:刷新页面
- 点击浏览器的 Refresh 按钮。
- 等待页面完成加载。
✅ 你应该会看到仪表板或上次打开的页面。
步骤 2:清除旧文件(浏览器缓存)
仅在刷新无效时执行以下步骤。
- 打开浏览器设置。
- 转到 Privacy 或 History。
- 清除 Cached images and files。
- 重新加载应用。
✅ 应用应该会加载最新版本。
步骤 3:尝试新标签页
- 打开新标签页。
- 输入 AVA 的网址。
- 如有需要,请重新登录。
✅ 新标签页通常会加载干净的文件。
常见场景
场景 1:应用持续重载
- 重试前等待 1 分钟。
- 然后刷新一次。
✅ 应用会阻止 1 分钟内的重复重载。
场景 2:只有一台设备显示空白屏幕
- 清除该设备上的浏览器缓存。
- 如果可以,请尝试其他浏览器。
✅ 这通常表示该设备存储了旧文件。
故障排查
入住页面显示加载画面
你看到的情况: 应用加载前,页面显示 Starting check-in...。
解决方法:
- 等待最多 10 秒,让启动设置完成加载。
- 如果出现 Retry 按钮,请点击。
- 如果仍未继续,请刷新页面。
- 如果问题重复出现,请重新登录。
“Unable to start check-in”
你看到的情况: 页面显示重试画面,并提示无法安全连接。
解决方法:
- 检查互联网连接。
- 点击 Retry。
- 如果错误再次出现,请刷新页面。
- 如果页面持续失败,请重新登录。
页面持续重载
你看到的情况: 页面重载超过一次。
解决方法:
- 等待 1 分钟。
- 刷新页面一次。
- 如果问题重复出现,请清除缓存文件。
翻译更改后重载
你看到的情况: 编辑翻译或切换语言后,页面持续重载。
解决方法:
-
等待 1 分钟。
-
刷新页面一次。
-
如果仍然循环,请清除缓存文件并重新登录。
✓ 翻译更新完成后,页面应该会停止重载。
返回标签页后屏幕短暂闪烁
你看到的情况: 返回 AVA 时注意到短暂的刷新闪烁。
解决方法:
- 在同一个标签页上等待 5-10 秒。
- 确认页面稳定下来,且没有完全重载。
- 只有在闪烁经常重复时才刷新一次。
选定的页面需要片刻才能打开
你看到的情况: 你选择了菜单项,但当前页面仍短暂可见。
解决方法:
- 等待选定的页面打开。
- AVA 加载新页面时,保持当前页面打开。
- 如果等待后选定的页面仍未打开,请刷新一次。
✓ 加载新页面时继续显示当前页面是正常现象。
登录后显示空白屏幕
你看到的情况: 应用本应加载完成后,页面显示白屏或空页面。
解决方法:
- 刷新页面。
- 在新标签页中打开应用。
- 如有需要,请清除缓存文件。
自助机在更新后持续显示旧字段
你看到的情况: 部署后,自助机或入住页面仍隐藏新字段。
解决方法:
- 等待一次性重载完成。
- 刷新自助机页面一次。
- 如果仍显示旧字段,请关闭标签页并重新打开入住链接。
- 如果同一设备上持续出现此问题,请清除缓存文件。
按钮不起作用
你看到的情况: 点击没有任何反应。
解决方法:
- 刷新页面。
- 退出登录,然后重新登录。
- 尝试其他浏览器。
导航面板不可用
你看到的情况: 左侧面板显示“Navigation unavailable”或“Sidebar crashed”。
解决方法:
- 继续在当前页面上操作。
- 在左侧面板中点击 Try again。
- 如果面板仍未加载,请刷新一次。
- 如有需要,请退出登录并重新登录。
仍无法解决?
如果出现以下情况,请联系 success@vouch-technologies.com:
- ❌ 10 分钟后应用仍然空白
- ❌ 刷新后入住重试画面仍反复出现
- ❌ 每次登录时应用都会重载
- ❌ 多位员工遇到同样的问题
建议一并提供:
- 问题开始的时间
- 浏览器名称和版本
- 空白屏幕的截图