应用反复重载或显示空白屏幕
快速设置
大多数重载或空白屏幕问题在刷新并清除缓存后 2 分钟内即可恢复。
本指南帮助你在 AVA 在更新后持续重载或显示空白屏幕时恢复正常。 自助机会在更新后重载一次，以便加载最新 bundle。
快速参考
| 你看到什么 | 原因 | 该怎么做 |
|---|---|---|
| 登录后空白屏幕 | 浏览器仍在使用旧文件 | 刷新并重新打开应用 |
| 登录后或更新后页面重载一次 | 应用正在更新到新文件 | 等待重载完成 |
| 语言选择器在翻译更改后持续重载 | 应用正在从翻译更新中恢复 | 等待稳定 |
| 返回标签页后短暂刷新 | AVA 正在执行后台会话检查 | 等待几秒钟 |
| 左侧面板显示“Navigation unavailable” | 侧边栏渲染失败 | 重试侧边栏 |
| 按钮没有响应 | 页面部分内容未加载 | 刷新并清除缓存 |
快速恢复步骤
- 等待 10 秒，看应用是否会自动重载。
- 点击浏览器的 Refresh 按钮。
- 如果屏幕仍然空白，关闭标签页并重新打开应用。
- 如果问题重复，等待 1 分钟后再试。
✅ 大多数情况下，完成这些步骤后应用都会正常加载。
详细修复步骤
步骤 1：刷新页面
- 点击浏览器的 Refresh 按钮。
- 等待页面加载完成。
✅ 你应该会看到仪表板或上一次打开的页面。
步骤 2：清除旧文件（浏览器缓存）
仅在刷新无效时使用这些步骤。
- 打开浏览器设置。
- 转到 Privacy 或 History。
- 清除 Cached images and files。
- 重新加载应用。
✅ 应用应该会加载最新版本。
步骤 3：尝试新标签页
- 打开一个新标签页。
- 输入 AVA 的网址。
- 如有需要，重新登录。
✅ 新标签页通常会加载干净文件。
常见场景
场景 1：应用一直重载
- 重试前等待 1 分钟。
- 然后刷新一次。
✅ 应用会阻止 1 分钟内的重复重载。
场景 2：只有一台设备显示空白
- 清除该设备上的浏览器缓存。
- 如果可以，试试其他浏览器。
✅ 这通常意味着该设备上存了旧文件。
故障排查
页面一直重载
你会看到： 页面重载超过一次。
解决方法：
- 等待 1 分钟。
- 刷新页面一次。
- 如果反复出现，清除缓存文件。
翻译变更后持续重载
你会看到： 在编辑翻译或切换语言后，页面不断重载。
解决方法：
-
等待 1 分钟。
-
刷新页面一次。
-
如果仍然循环，清除缓存文件并重新登录。
✓ 翻译更新完成后，页面应该会停止重载。
返回标签页后短暂闪烁
你会看到： 你返回 AVA 时，注意到短暂的刷新闪烁。
解决方法：
- 在同一个标签页上等待 5-10 秒。
- 确认页面稳定下来，没有发生完整重载。
- 只有在闪烁经常重复时才刷新一次。
登录后空白屏幕
你会看到： 白屏或空页面。
解决方法：
- 刷新页面。
- 在新标签页中打开应用。
- 必要时清除缓存文件。
自助机在更新后仍显示旧字段
你会看到： 部署后，自助机或入住页面仍然隐藏一个新字段。
解决方法：
- 等待一次性重载完成。
- 刷新一次自助机页面。
- 如果旧字段仍然出现，关闭标签页并重新打开入住链接。
- 如果同一设备上一直如此，请清除缓存文件。
房间列表仍显示旧布局
你会看到： 普通 iPad 仍显示旧的多房间网格，或 iPad Pro 在更新后仍一次只显示一间房。
解决方法：
-
刷新入住页面一次。
-
关闭自助机应用或浏览器会话。
-
在新会话中重新打开入住链接。
-
如果布局仍然看起来过旧，重启设备。
✓ 在新会话后应该会加载当前房间列表布局。
按钮不能用
你会看到： 点击没有任何反应。
解决方法：
- 刷新页面。
- 退出并重新登录。
- 尝试其他浏览器。
导航面板不可用
你会看到： 左侧面板显示“Navigation unavailable”或“Sidebar crashed”。
解决方法：
- 继续在当前页面上操作。
- 在左侧面板中点击 Try again。
- 如果面板仍未加载，刷新一次。
- 如有需要，退出并重新登录。
还卡住吗？
如果出现以下情况，请联系 success@vouch-technologies.com：
- ❌ 10 分钟后应用仍然空白
- ❌ 每次登录应用都会重载
- ❌ 多位员工都遇到同样的问题
建议附上：
- 问题开始时间
- 浏览器名称和版本
- 空白屏幕截图