账号系统报错
账号登录、绑定、认证过程中可能出现的报错、解决方案及说明
本文档汇总 AstroBox 在小米/vivo 账号登录、AstroBox 账号管理、绑定解绑等流程中可能向用户展示的报错信息。常见报错与解决方案已置顶，完整清单见文末。
常见报错与解决方案
登入失敗：serviceLoginAuth2 returned credential challenge again
报错原文
登入失敗：serviceLoginAuth2 returned credential challenge again; body=xxxxxxxxx触发场景：小米账号登录第二步认证（serviceLoginAuth2）时仍返回凭据校验要求，即登录时账号或密码错误。
解决方案：确认账号密码正确，注意大小写；如忘记密码请先通过小米官方渠道找回。
源码位置：src-tauri/modules/account/src/xiaomi.rs:1593
小米账号登录失败：用户名或密码错误
报错原文
小米账号登录失败：用户名或密码错误触发场景：小米账号用户名或密码错误（API 返回 70016 时同样显示「登录失败：用户名或密码错误」）。
解决方案：确认账号密码正确，注意大小写，或通过小米官方渠道找回密码。
源码位置：frontapi/account.rs:1746 / frontapi/account.rs:2094
原生小米账号登录窗口已在运行，请关闭后重试
报错原文
原生小米账号登录窗口已在运行，请关闭后重试触发场景：登录窗口已打开时再次触发登录。
解决方案：关闭已有的登录窗口后重试。
源码位置：frontapi/account.rs:270
等待小米账号两步验证超时
报错原文
等待小米账号两步验证超时触发场景：两步验证（2FA）页面未在预期时间内完成验证。
解决方案：检查网络连接，确认验证码/二次验证操作已完成，或尝试重新登录。
源码位置：frontapi/account.rs:605 / frontapi/account.rs:824
vivo 登录已完成，但未能从页面或 cookie 中取得 openid
报错原文
vivo 登录已完成，但未能从页面或 cookie 中取得 openid触发场景：vivo 登录流程走完但拿不到 openid，常见于网络异常或页面未正常跳转。
解决方案：检查网络连接，或尝试重新登录。
源码位置：frontapi/account.rs:939
完整报错清单
一、Toast 弹窗报错
AstroBox 账号与绑定
| 触发位置 | 消息 Key | 说明 |
|---|---|---|
pages/settings/account.tsx:449 | settings.account.bindSuccess | BandBBS 绑定 AstroBox 成功 |
pages/settings/account.tsx:452 | settings.account.bindFailed + message | BandBBS 绑定失败 |
pages/settings/account.tsx:493 | settings.account.unbindSuccess | BandBBS 解绑成功 |
pages/settings/account.tsx:496 | settings.account.unbindFailed + message | BandBBS 解绑失败 |
guards/BandBbsAuthorizationGuard.tsx:115 | settings.account.bandBbsSyncNetworkError | 同步绑定信息时网络异常（仅 Tauri） |
小米账号
| 触发位置 | 消息 Key | 说明 |
|---|---|---|
pages/settings/account.tsx:550 | settings.account.xiaomi.importSuccess + count | 小米设备导入成功 |
pages/settings/account.tsx:557 | settings.account.xiaomi.importFailed + message | 小米设备导入失败 |
pages/settings/account.tsx:569 | settings.account.xiaomi.logoutSuccess | 小米账号登出成功 |
pages/settings/account.tsx:572 | settings.account.xiaomi.logoutFailed + message | 小米账号登出失败 |
vivo 账号
| 触发位置 | 消息 Key | 说明 |
|---|---|---|
pages/settings/account.tsx:589 | settings.account.vivo.loginSuccess | vivo 登录成功 |
pages/settings/account.tsx:592 | settings.account.vivo.loginFailed + message | vivo 登录失败 |
pages/settings/account.tsx:604 | settings.account.vivo.logoutSuccess | vivo 登出成功 |
pages/settings/account.tsx:607 | settings.account.vivo.logoutFailed + message | vivo 登出失败 |
账号注销
| 触发位置 | 消息 Key | 说明 |
|---|---|---|
pages/settings/accountDeletion.tsx:216 | settings.account.deletion.submitSuccess + ticket id | 注销工单创建成功 |
pages/settings/accountDeletion.tsx:223 | settings.account.deletion.submitFailed + message | 注销工单创建失败 |
社交限制与封禁
| 触发位置 | 消息 | 说明 |
|---|---|---|
logic/api/astrobox/request.ts:162 | 你的社交功能已被限制，解除时间：... | 后端返回 social-banned |
logic/api/astrobox/request.ts:169 | 账号已被封禁：... | 后端返回 user-banned，随后登出 |
App.tsx:384 | account.sessionExpired | 账号会话过期事件 |
通用复制
| 触发位置 | 消息 Key | 说明 |
|---|---|---|
pages/settings/account.tsx:107 | common.copied | 账号 ID 复制成功 |
pages/settings/account.tsx:110 | common.copyFailed | 账号 ID 复制失败 |
二、Rust 后端返回错误
小米账号登录
| 位置 | 错误消息 | 触发条件 |
|---|---|---|
frontapi/account.rs:270 | 原生小米账号登录窗口已在运行，请关闭后重试 | 登录窗口冲突 |
frontapi/account.rs:317 | {context} 缺少小米账号 ID，拒绝保存不完整登录态 | 不完整账号保存 |
frontapi/account.rs:478 | 拉起原生小米账号两步验证页面超时 | 2FA 超时 |
frontapi/account.rs:505 | 无法拉起 iOS 原生小米账号两步验证页面 | iOS 2FA 启动失败 |
frontapi/account.rs:514 | 原生小米账号两步验证失败: {err} | 2FA 失败 |
frontapi/account.rs:552 | 两步验证已完成，但原生验证页未返回 account.xiaomi.com 的 cookie | 2FA 缺少 cookie |
frontapi/account.rs:605 | 等待小米账号两步验证超时 | 2FA 等待超时 |
frontapi/account.rs:718 | 两步验证已完成，但未能读取到 account.xiaomi.com 的 cookie | 2FA cookie 读取失败 |
frontapi/account.rs:809 | 小米账号两步验证窗口已被关闭 | 2FA 窗口被关闭 |
frontapi/account.rs:820 | 小米账号两步验证窗口状态丢失 | 2FA 窗口状态丢失 |
frontapi/account.rs:824 | 等待小米账号两步验证超时 | 2FA 等待超时 |
frontapi/account.rs:1746 | 小米账号登录失败：用户名或密码错误 | 凭据错误 |
frontapi/account.rs:2034 | 小米账号登录失败：{err} | 通用登录失败 |
frontapi/account.rs:2094 | 登录失败：用户名或密码错误 | API 错误 70016 |
frontapi/account.rs:2131 | 小米账号登录过期，请重新登录 | 会话过期 |
frontapi/account.rs:2307 | Xiaomi device id is required | 固件检查验证 |
frontapi/account.rs:2310 | Xiaomi device model is required | 固件检查验证 |
frontapi/account.rs:2313 | Current firmware version is required | 固件检查验证 |
vivo 账号登录
| 位置 | 错误消息 | 触发条件 |
|---|---|---|
frontapi/account.rs:291 | 原生 vivo 登录窗口已在运行，请关闭后重试 | 登录窗口冲突 |
frontapi/account.rs:939 | vivo 登录已完成，但未能从页面或 cookie 中取得 openid | 缺少 openid |
frontapi/account.rs:1162 | vivo 登录窗口已被关闭 | 登录窗口被关闭 |
frontapi/account.rs:1172 | vivo 登录窗口状态丢失 | 登录窗口状态丢失 |
frontapi/account.rs:1176 | 等待 vivo 登录超时 | 登录等待超时 |
frontapi/account.rs:1268 | 拉起原生 vivo 登录页面超时 | 登录超时 |
frontapi/account.rs:1294 | 无法拉起 iOS 原生 vivo 登录页面 | iOS 登录启动失败 |
frontapi/account.rs:1315 | 原生 vivo 登录失败: {err} | 登录失败 |
frontapi/account.rs:1328 | 等待 vivo 登录超时 | 登录等待超时 |
frontapi/account.rs:2371 | vivo device id is required | OTA 验证 |
frontapi/account.rs:2374 | vivo OTA device model is required | OTA 验证 |
frontapi/account.rs:2377 | Current firmware version is required | OTA 验证 |
通用账号
| 位置 | 错误消息 | 触发条件 |
|---|---|---|
frontapi/account.rs:2156 | provider not found | 账号提供商查找失败 |
三、WASM / 逻辑层抛错
| 位置 | 错误消息 | 触发条件 |
|---|---|---|
logic/xiaomi.ts:182 | 小米 API 相关错误 | 小米 API 调用失败 |
logic/xiaomi.ts:245 | 小米 API 相关错误 | 小米 API 调用失败 |
pages/settings/account.tsx:95 | clipboard unavailable | 剪贴板不可用 |
四、其他排查建议
| 报错 | 建议操作 |
|---|---|
用户名或密码错误 | 确认账号密码正确，注意大小写 |
小米账号登录窗口已在运行 | 关闭已有的登录窗口后重试 |
等待两步验证超时 | 检查网络连接，或尝试重新登录 |
原生验证页未返回 cookie | 完成 2FA 后确保页面正常跳转，或尝试重新登录 |
settings.account.bandBbsSyncNetworkError | 检查网络连接，稍后自动重试 |
账号已被封禁 | 联系 AstroBox 客服了解封禁原因 |
你的社交功能已被限制 | 等待限制解除时间到期 |
account.sessionExpired | 重新登录 AstroBox 账号 |
Current firmware version is required | 先连接设备以获取当前固件版本 |