跳到主要内容

智能锁故障排查

快速修复

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

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

快速参考​

你看到的情况原因处理方式
“Failed to generate lock code”供应商连接问题或锁离线检查供应商与锁状态
Manage PIN 被禁用房间尚未分配、房间数据尚未同步，或房间尚未映射到锁先打开 Room Access，再刷新
PIN 已生成但无法开锁PIN 未同步到锁，或桥接器离线在供应商应用中验证 PIN
“PIN generation failed for all locks”（Smart Lock Setup）供应商故障或所有锁都无法访问刷新后重新测试
Smart Lock Setup 中没有锁供应商未关联或没有同步锁刷新或重新连接
客人收到错误门码锁映射到了错误房间修正房间映射
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. 在 AVA 中点击 Refresh Locks。
  3. 如果问题仍然存在，请在 Room Access 中重新连接供应商。
  4. 如果客人正在等待，请在供应商应用中发放手动密码，或者使用实体钥匙。

生成的 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 中。

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）
  • 受影响的锁具数量
  • 错误信息截图

相关指南​