Passkey 同步成功但签名失败，十有八九是设备权限或浏览器设置挡了路。先别怀疑钱包坏了，按下面两个方向查：确认当前网站域名和你存 Passkey 时的域名完全一致，再检查浏览器有没有权限调用你手机或电脑的安全芯片。
步骤 1：核对 RP ID（依赖方域名）
Passkey 和创建时的网站域名是绑定的，这叫 RP ID（Relying Party ID）。你在 web.token.im 存的 Passkey，在 test.token.im 或其他子域名下就调不出来。imToken Web 也明确强调，Passkey 密钥是绑定官网域名的，天然防钓鱼。
怎么做：检查你当前浏览器地址栏里的完整域名。是不是和创建账户时完全一样？注意有没有多出
www、少了某个字母，或者用了 IP 地址访问。完成标准：地址栏显示的域名和你存 Passkey 时的域名完全一致，子域名也不能差。
步骤 2：检查云同步账户的 Passkey 提供权限
Passkey 同步到新设备后，系统需要知道你允许哪个应用或密码管理器来提供这个密钥。
情况 A：iPhone 用户
怎么做：打开"设置" → "通用" → "自动填充与密码"，确认"自动填充密码"开关已打开，并且勾选的是"iCloud 密码与钥匙串"。如果关闭了，系统就不会从 iCloud 钥匙串里调取 Passkey。
完成标准："自动填充密码"为开启状态，且"iCloud 密码与钥匙串"被勾选。
情况 B：Android 用户
怎么做：打开"设置" → 搜索"密码"或"Passkey"相关选项（不同品牌路径不同，可能在"Google" → "密码管理工具"或"系统和更新"下），确认你的 Google 账户或设备默认的密码管理器已被启用为 Passkey 提供方。
完成标准：系统设置里明确显示当前账户可作为 Passkey 提供者。
高危风险：某些 Android 机型（如华为、小米、vivo、OPPO 的部分型号）暂不支持 Passkey 功能，在 imToken Web 上可能无法正常签名或创建账户。如果你用的是这些机型，建议换一台支持 Passkey 的设备或使用电脑浏览器（Chrome、Edge、Safari）操作。
步骤 3：检查浏览器权限与兼容性
浏览器的安全机制也可能阻止网站调用 Passkey。
怎么做：
更新浏览器：确保你使用的 Safari、Chrome 或 Edge 是最新版。旧版本可能对 Passkey 支持不完整。
清除缓存与 Cookie：有些临时数据会干扰认证流程。清除
web.token.im的站点数据再重试。检查是否在无痕/隐私模式：部分浏览器隐私模式会禁用 Passkey 这类 WebAuthn 接口。退出隐私模式再试。
完成标准：浏览器更新到最新版，清除站点数据后，在普通模式下重试签名。
步骤 4：确认是否满足"用户验证"（User Verification）
这是最容易忽略的坑。某些网站要求签名时必须验证你的生物信息（面容/指纹）。但如果你在设备设置里关闭了"密码自动填充"调用 Face ID 或指纹的权限，系统会直接返回失败，连提示都不一定弹。
怎么做（iPhone）：打开"设置" → "面容 ID 与密码" → "使用面容 ID"，确认"密码自动填充"这一项是开启的。如果关闭，系统不会弹出面容验证，签名就会静默失败。
完成标准："密码自动填充"对应的生物识别开关为开启状态。
常见失败原因
域名多了一个
www：你在token.im存的密钥，在www.token.im下调不出来。这是 RP ID 精确匹配机制导致的，不是 Bug。跨设备签名时蓝牙未开或网络不通：如果用手机给电脑扫码签名，需要两台设备都开启蓝牙并连接互联网，否则会提示"设备无法连接"。
操作完成后
校验方式：完成上述权限检查后，重新在 imToken Web 发起一次转账或授权操作。看系统是否弹出面容 ID、指纹或 PIN 码验证窗口。弹出验证窗口，说明通道通了；继续弹错或没有反应，再按步骤逐一排查。
