跳到主要内容

智能锁故障排查

快速修复

先点击 Refresh Locks，再针对一个房间运行 Test PIN Generation。通常只需 2 分钟。

本指南帮助你解决 Igloohome、TTLock 和 Wishome 的常见智能锁问题。

房间专属 PIN

AVA 会把每个 PIN 绑定到预订上的 PMS 房间。 在非 Opera 的 PMS 配置中，AVA 会使用该房间自己的确认号来进行智能锁访问。 在 Opera OHIP 多房间预订中，AVA 创建智能锁访问时会使用每个子预订的房号。 如果客人换房，请等待同步完成后再生成新的 PIN。 对于多房间预订，每个房间都会使用自己的子预订或房间级 ID。 这样批量生成 PIN 时就能对应到正确的房间。 当你重新打开查询时，AVA 还可以恢复同一预订家族中的关联房间。

Igloohome 更新更快

对于 Igloohome 门锁，当完成事件到达时，AVA 通常会立刻将已完成的 PIN 标记为 Successful。 如果你仍然看到 pending，请先刷新一次。 后台轮询仍会捕获遗漏的更新。

快速参考​

你看到的情况原因处理方式
"Failed to generate lock code"供应商连接问题或锁离线检查供应商与锁状态
刷新后失败的 PIN 重新可用AVA 在下一次预订拉取时重新尝试生成，包括同一预订家族中的关联房间刷新预订
Manage PIN 被禁用房间尚未分配、房间数据尚未同步，或房间尚未映射到锁先打开 Room Access，再刷新
PIN 已生成但无法开锁PIN 未同步到锁，或桥接器离线在供应商应用中验证 PIN
Operation 状态一直是 pending 或显示 partial供应商桥接任务仍在处理等待并刷新
"PIN generation failed for all locks"（Smart Lock Setup）供应商故障或所有锁都无法访问刷新后重新测试
Smart Lock Setup 中没有锁供应商未关联或没有同步锁刷新或重新连接
"Operation not supported" 或某个操作被禁用锁型号或供应商不支持该操作检查支持能力
客人收到错误门码锁映射到了错误房间，或预订指向了错误的 PMS 房间检查房间映射和预订房间
Igloohome 在 OAuth 成功后仍显示 Not linked回调已返回，但状态尚未刷新刷新 Igloohome 状态

Manage PIN 被禁用​

你看到的情况： Manage PIN 按钮是灰色的，或者你无法为客人生成 PIN。

解决方法：

  1. 确认该预订已分配房间。

  2. 如果房间为空，请先在 PMS 中分配房间。

  3. 等待 1 到 2 分钟让同步完成，然后刷新 AVA。

  4. 前往 Settings → Room Access，确认该房间已在 Smart Lock Setup 中映射到某把锁。

  5. 如果提示中带有链接，请点开它，直接跳转到 Settings → Room Access。

    ✓ 房间分配完成并映射后，Manage PIN 应该就可用了。

代码生成失败​

你看到的情况： 入住时出现 “Failed to generate lock code”，或者生成的 PIN 无法使用。

解决方法：

  1. 刷新预订，或者如果客人已经入住，就从预订查询中重新打开。

    • 如果这是多房间预订，也请重新打开父确认号。

  2. 验证锁具电量充足，并且在供应商应用中有响应。

  3. 在 AVA 中点击 Refresh Locks。

  4. 如果问题仍然存在，请在 Room Access 中重新连接供应商。

  5. 如果客人正在等待，请在供应商应用中发放手动密码，或者使用实体钥匙。

    ✓ AVA 会在下一次获取符合条件的在住预订时重试智能锁 PIN 生成。

Operation 状态一直是 pending 或 partial​

你看到的情况： 创建智能锁门码后，状态显示 pending 或 partial。

解决方法：

  1. 最多等待 1 分钟，然后刷新预订或 Access Codes 页面。
  2. AVA 会优先检查较新的智能锁任务，因此新生成的客人 PIN 应先完成。
  3. 刷新入住查询时，AVA 会在返回门码前重新检查待处理任务。
  4. AVA 会跳过已过期的历史 Active 记录，即使旧的桥接字段仍然存在。
  5. AVA 会在后台继续检查供应商任务，因此当前住宿可能无需其他操作就变为 Successful。
  6. 在等待入住期间，AVA 也会刷新待处理的智能锁任务，以便更快显示可用 PIN。
  7. 如果看到 partial，请等待状态完成后再向客人提供 PIN。
  8. 如果当前住宿的状态保持 pending 超过 1 分钟，请从预订中重新创建 PIN。
  9. 如果状态变为 Timed out 或 Failed，请检查供应商桥接器，并在需要时重新连接供应商。

生成的 PIN 无法在锁上使用​

你看到的情况： AVA 成功生成了 PIN 码，但客人在开门时 PIN 不起作用。

解决方法：

  1. 在供应商应用中核对 PIN：

    • 打开你供应商的智能锁应用（Igloohome、TTLock 或 Wishome）
    • 检查供应商应用中显示的 PIN 是否与 AVA 生成的一致
    • 查看是否对应同一条预订或同一时间段

  2. 如果 PIN 不匹配，或供应商应用中没有显示：

    • 对于没有桥接器的锁： 通过取出并重新装入电池来重启锁
    • 对于带有桥接器/网关的锁：
      • 拔掉桥接器电源 30 秒，然后重新插回去
      • 等待 2 到 3 分钟让桥接器重新连接
      • 在供应商应用中确认桥接器显示为在线
    • 重置后，在 AVA 中点击 Refresh Locks
    • 再尝试生成新的 PIN

  3. 如果问题仍然存在：

    • 在供应商应用中检查锁的电池电量（低电量可能导致同步问题）
    • 确保锁与桥接器之间连接稳定（如适用）
    • 在供应商应用中确认锁的固件是最新版本

Smart Lock Setup 中的 PIN 测试失败​

你看到的情况： Smart Lock Setup 中显示 “PIN generation failed for all locks.”。

解决方法：

  1. 点击 Refresh Locks。
  2. 使用 Test PIN Generation 再次测试单个房间。
  3. 如果所有测试都失败，请在 Room Access 中重新连接供应商。

Smart Lock Setup 中没有锁​

你看到的情况： Available Devices 为空。

解决方法：

  1. 确认供应商账号已连接。
  2. 点击 Refresh Locks。
  3. 在供应商应用中确认锁已出现，并且与所选供应商一致。

锁映射到了错误房间​

你看到的情况： 客人收到了错误房间的门码。

解决方法：

  1. 前往 Settings → Room Access。

  2. 滚动到 Smart Lock Setup。

  3. 选择该房间并移除错误的锁。

  4. 分配正确的锁。

    ✓ 正确的锁会显示在 Assigned Devices 中。

客人收到错误门码​

你看到的情况： 更换房间或处理多房间预订后，客人收到错误房间的门码。

解决方法：

  1. 前往 Settings → Room Access。

  2. 滚动到 Smart Lock Setup。

  3. 确认预订显示正确的 PMS room。

  4. 如果是 Opera OHIP 预订，请确认每个房间都有各自的子预订房号。

  5. 如果是多房间预订，请确认每个房间都有各自的子预订 ID。

  6. 如果不是 Opera 预订，请确认每个房间都有各自的房间确认号。

  7. 选择房间，并在需要时移除错误的锁。

  8. 分配正确的锁。

  9. 等待同步，然后再次运行 Refresh Locks 和 Test PIN Generation。

    ✓ 正确的锁会显示在 Assigned Devices 中。

不支持此操作​

你看到的情况： AVA 提示锁或供应商不支持你尝试的操作。

原因： 该锁型号不支持此功能，或者供应商限制了该操作。

解决方法：

  1. 前往 Settings → Room Access。

  2. 点击 Refresh Locks。

  3. 检查 Smart Lock Setup 中的功能标签。

  4. 如果该操作仍处于禁用状态，请使用其他锁型号或供应商。

    ✓ AVA 只显示已连接锁能够执行的操作。

Igloohome 专属问题​

Igloohome 在 OAuth 成功后仍显示 Not linked​

你看到的情况： 你已经完成 OAuth，但 Igloohome Locks 仍显示 Not linked。

解决方法：

  1. 在 OAuth 返回后，继续停留在 Settings → Room Access。
  2. 等待几秒，让状态刷新。
  3. 如果状态没有变化，刷新页面一次。
  4. 如果仍显示 Not linked，请重新关联账号。

OAuth 连接过期​

你看到的情况： 集成显示为断开。

解决方法：

  1. 在 Igloohome Locks 中点击 Disconnect。
  2. 点击 Link Account。
  3. 完成 OAuth 授权。

锁未显示​

解决方法：

  1. 确认锁在 Igloohome 中已分配给该物业。
  2. 返回 AVA 并点击 Refresh Locks。

TTLock 专属问题​

登录失败​

你看到的情况： 显示 “Failed to connect TTLock account.”。

解决方法：

  1. 确认用户名和密码正确，且区分大小写。
  2. 验证 TTLock 应用中的账号处于活动状态。
  3. 30 秒后重试。

锁未同步​

解决方法：

  1. 打开 TTLock 手机应用。
  2. 靠近每把锁进行同步。
  3. 返回 AVA 并点击 Refresh Locks。

Wishome 专属问题​

凭据不完整或令牌过期​

你看到的情况： 显示 “Wishome credentials incomplete” 或令牌过期警告。

解决方法：

  1. 重新输入 Wishome Account Name 和 Wishome Password。
  2. 确认 Offline Password Version 与你的 Wishome 设置一致。
  3. 点击 Connect Wishome Account。

仍然卡住？​

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

  • ❌ 所有锁在网络正常的情况下仍显示离线
  • ❌ 供应商凭据正确但连接失败
  • ❌ 多次重试后 PIN 仍然失败

建议附上：

  • 锁具供应商（Igloohome、TTLock 或 Wishome）
  • 受影响的锁具数量
  • 错误信息截图

相关指南​