应用反复重载或显示空白屏
快速处理
多数重载或空白屏问题在刷新和清缓存后 2 分钟内可恢复，通常不需要重装应用。
本指南帮助你在 AVA 更新后出现反复重载或空白屏时快速恢复。 Kiosk 设备可能会在更新后重载一次，以便加载最新的构建。
快速参考
| 你看到的现象 | 原因 | 处理方式 |
|---|---|---|
| 登录后空白屏 | 浏览器仍在使用旧文件 | 刷新并重新打开应用 |
| 登录后页面重载一次，或更新后页面重载一次 | 应用正在切换到新文件 | 等待重载完成 |
| 切换语言后语言选择器持续重载 | 应用正在从翻译更新中恢复 | 等待它稳定下来 |
| 切回标签页后短暂刷新 | 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 秒。
- 确认页面稳定下来，没有整页重载。
- 只有在闪烁经常重复时才再次刷新。
登录后空白屏
你会看到： 白屏或空页面。
解决方法：
- 刷新页面。
- 在新标签页中打开应用。
- 如有需要，清理缓存文件。
Kiosk 在更新后仍显示旧字段
你会看到： 部署后，kiosk 或入住页面仍然隐藏一个新字段。
解决方法：
- 等待一次性重载完成。
- 刷新 kiosk 页面一次。
- 如果旧字段仍然出现，关闭标签页并重新打开入住链接。
- 如果同一台设备持续出现这个问题，清理缓存文件。
按钮无法使用
你会看到： 点击没有反应。
解决方法：
- 刷新页面。
- 退出登录并重新登录。
- 尝试其他浏览器。
导航面板不可用
你会看到： 左侧面板显示 “Navigation unavailable” 或 “Sidebar crashed.”
解决方法：
- 先继续在当前页面操作。
- 在左侧面板选择 Try again。
- 如果面板仍未加载，刷新一次。
- 如有需要，退出登录后重新登录。
仍然无法解决？
如有以下情况，请联系 success@vouch-technologies.com：
- ❌ 10 分钟后应用仍为空白
- ❌ 每次登录都会重载
- ❌ 多位员工同时遇到相同问题
建议提供：
- 问题开始时间
- 浏览器名称与版本
- 空白屏截图