跳到主要内容

应用重载或显示空白屏幕

快速设置

大多数重载或空白屏幕问题在刷新并清除缓存后不到 2 分钟即可解决。

本指南可帮助你解决 AVA 持续重载、显示空白屏幕或无法启动入住流程的问题。 本指南还说明了配对的自助机无法加载时显示的恢复屏幕。 自助机可能会在更新后重载一次，以便加载最新的软件包。 AVA 加载由 PMS 支持的入住设置时，也可能会短暂等待。

快速参考​

你看到的情况原因操作
入住页面显示 Starting check-in...AVA 正在加载安全启动设置或由 PMS 支持的设置短暂等待或重试
显示 "Unable to start check-in"安全启动未能完成检查连接并重试
配对的自助机显示连接恢复屏幕自助机失去网络连接或无法恢复登录状态按照恢复步骤操作
自助机显示 Reconnecting...AVA 正在自动重试登录等待自动恢复
自助机显示启动恢复画面而不是空白屏幕自助机无法加载入住文件重试自助机启动
登录后显示空白屏幕浏览器仍在使用旧文件刷新并重新打开应用
登录后或更新后页面重载一次应用正在更新为新文件等待重载完成
ACI 显示新版本横幅前台标签页发现了较新的 AVA 部署版本完成当前客人的入住，然后刷新
更改翻译后语言选择器持续重载应用正在从翻译更新中恢复等待其稳定下来
返回标签页后短暂刷新AVA 正在执行后台会话检查等待几秒
选定的页面没有立即打开AVA 正在加载该页面的文件等待后再刷新
左侧面板显示 "Navigation unavailable"侧边栏渲染失败重试侧边栏
按钮没有响应页面部分内容未加载刷新并清除缓存

快速恢复步骤​

  1. 等待 10 秒，查看应用是否会自行重载。
  2. 点击浏览器的 Refresh 按钮。
  3. 如果屏幕仍然空白，请关闭标签页，然后重新打开应用。
  4. 如果问题重复出现，请等待 1 分钟后重试。

✅ 大多数情况下，完成这些步骤后应用会正常加载。

详细修复步骤​

步骤 1：刷新页面​

  1. 点击浏览器的 Refresh 按钮。
  2. 等待页面完成加载。

✅ 你应该会看到仪表板或上次打开的页面。

步骤 2：清除旧文件（浏览器缓存）​

仅在刷新无效时执行以下步骤。

  1. 打开浏览器设置。
  2. 转到 Privacy 或 History。
  3. 清除 Cached images and files。
  4. 重新加载应用。

✅ 应用应该会加载最新版本。

步骤 3：尝试新标签页​

  1. 打开新标签页。
  2. 输入 AVA 的网址。
  3. 如有需要，请重新登录。

✅ 新标签页通常会加载干净的文件。

常见场景​

场景 1：应用持续重载

  • 重试前等待 1 分钟。
  • 然后刷新一次。

✅ 应用会阻止 1 分钟内的重复重载。

场景 2：只有一台设备显示空白屏幕

  • 清除该设备上的浏览器缓存。
  • 如果可以，请尝试其他浏览器。

✅ 这通常表示该设备存储了旧文件。

故障排查​

入住页面显示加载画面​

你看到的情况： 应用加载前，页面显示 Starting check-in...。

解决方法：

  1. 等待最多 10 秒，让启动设置完成加载。
  2. 如果出现 Retry 按钮，请点击。
  3. 如果仍未继续，请刷新页面。
  4. 如果问题重复出现，请重新登录。

"Unable to start check-in"​

你看到的情况： 页面显示重试画面，并提示无法安全连接。

解决方法：

  1. 检查互联网连接。
  2. 点击 Retry。
  3. 如果错误再次出现，请刷新页面。
  4. 如果页面持续失败，请重新登录。

配对的自助机显示连接恢复屏幕​

你看到的情况： 自助机显示 Reconnecting... 和倒计时，或显示带有 Try again 和 Reload app 的编号恢复步骤。

解决方法：

  1. 确认自助机已连接到酒店 Wi-Fi。

  2. 当屏幕显示 Reconnecting... 时，最多等待 20 秒。

  3. 如果出现恢复步骤，请选择 Try again。

  4. 等待重试完成，最多可能需要 15 秒。

  5. 如果自助机仍未恢复，请选择 Reload app。

  6. 网络恢复期间保持自助机处于打开状态。

    ✓ 自助机重新连接后，恢复屏幕应会关闭。

自助机会在服务或身份验证发生故障期间自动重试。 如果已安排自动尝试，脚注会显示下一次自动尝试的时间。 在显示员工操作步骤前，你可能会短暂看到 Reconnecting...。

自助机显示启动恢复画面​

你看到的情况： 自助机显示恢复消息，而不是欢迎屏幕。 当自助机启动文件加载缓慢或失败时，可能会显示恢复屏幕。

解决方法：

  1. 确认自助机已连接到酒店 Wi-Fi。

  2. 短暂等待 AVA 自动重试启动。

  3. 如果恢复屏幕提供 Try again，请选择该选项。

  4. 如果自助机仍未启动，请选择 Reload app。

  5. 恢复屏幕期间不要更改配对或自助机链接。

    ✓ 文件加载后，自助机应返回欢迎屏幕。

AVA 会在恢复期间保留自助机的配对和链接详细信息。 对于此启动问题，无需再次配对自助机。 如果恢复屏幕再次出现，请先检查网络，然后重试。

服务中断期间自助机停留在恢复屏幕​

你看到的情况： 自助机已连接 Wi-Fi，但由于某项 AVA 服务不可用，恢复屏幕仍保持打开。

解决方法：

  1. 让自助机停留在恢复屏幕上。
  2. 等待 AVA 在后台自动重试。
  3. 选择 Try again 以开始重试，并等待结果。
  4. 只有在服务恢复后恢复屏幕仍未关闭时，才选择 Reload app。

当自动尝试即将进行时，屏幕会显示 Reconnecting...。 如果恢复未能在短暂宽限期内完成，屏幕会显示员工操作步骤。 Next automatic attempt 脚注会显示计划中的重试时间。 只要自助机保持打开，重试就会继续，包括夜间时段。 自助机页面隐藏时，会暂停后台重试。

✓ 服务再次可用后，恢复屏幕会关闭。

如果屏幕再次出现，请按照在入住期间保持自助机连接中的步骤操作。

页面持续重载​

你看到的情况： 页面重载超过一次。

解决方法：

  1. 等待 1 分钟。
  2. 刷新页面一次。
  3. 如果问题重复出现，请清除缓存文件。

翻译更改后重载​

你看到的情况： 编辑翻译或切换语言后，页面持续重载。

解决方法：

  1. 等待 1 分钟。

  2. 刷新页面一次。

  3. 如果仍然循环，请清除缓存文件并重新登录。

    ✓ 翻译更新完成后，页面应该会停止重载。

返回标签页后屏幕短暂闪烁​

你看到的情况： 返回 AVA 时注意到短暂的刷新闪烁。

解决方法：

  1. 在同一个标签页上等待 5-10 秒。
  2. 确认页面稳定下来，且没有完全重载。
  3. 只有在闪烁经常重复时才刷新一次。

选定的页面需要片刻才能打开​

你看到的情况： 你选择了菜单项，但当前页面仍短暂可见。

解决方法：

  1. 等待选定的页面打开。
  2. AVA 加载新页面时，保持当前页面打开。
  3. 如果等待后选定的页面仍未打开，请刷新一次。

✓ 加载新页面时继续显示当前页面是正常现象。

登录后显示空白屏幕​

你看到的情况： 应用本应加载完成后，页面显示白屏或空页面。

解决方法：

  1. 刷新页面。
  2. 在新标签页中打开应用。
  3. 如有需要，请清除缓存文件。

自助机在更新后持续显示旧字段​

你看到的情况： 部署后，自助机或入住页面仍隐藏新字段。

解决方法：

  1. 等待一次性重载完成。
  2. 刷新自助机页面一次。
  3. 如果仍显示旧字段，请关闭标签页并重新打开入住链接。
  4. 如果同一设备上持续出现此问题，请清除缓存文件。

ACI 显示新版本横幅​

你看到的情况： 员工 ACI 屏幕提示有新的 AVA 版本可用。

原因： AVA 部署期间浏览器标签页一直处于打开状态。 该标签页会在你工作时检查是否有更新的文件。

解决方法：

  1. 完成当前客人的入住，或安全地暂停该入住流程。

  2. 选择横幅中的刷新操作，或点击浏览器的 Refresh 按钮。

  3. 等待员工界面加载完成后，再开始办理下一位客人。

    ✓ 员工界面应该会显示最新的 AVA 版本。

面向客人的入住屏幕不会显示此横幅。 输入客人信息或查看到店信息时，请勿刷新。 在这些步骤中刷新可能会清除正在进行的选择。 如果刷新后自助机短暂显示 Reconnecting...，请等待倒计时结束。 只有在出现恢复步骤时，才选择 Try again。

按钮不起作用​

你看到的情况： 点击没有任何反应。

解决方法：

  1. 刷新页面。
  2. 退出登录，然后重新登录。
  3. 尝试其他浏览器。

你看到的情况： 左侧面板显示 "Navigation unavailable" 或 "Sidebar crashed."。

解决方法：

  1. 继续在当前页面工作。
  2. 在左侧面板中选择 Try again。
  3. 如果面板仍未加载，请刷新一次。
  4. 如有需要，请退出登录并重新登录。

仍然无法解决？​

如果出现以下情况，请联系 success@vouch-technologies.com：

  • ❌ 应用在 10 分钟后仍为空白
  • ❌ 刷新后入住重试屏幕仍不断出现
  • ❌ 每次登录时应用都会重载
  • ❌ 多名员工遇到相同问题

建议提供：

  • 问题开始的时间
  • 浏览器名称和版本
  • 空白屏幕的截图