# 登录问题排查
> 二维码打不开、验证码收不到、扫码后卡住、登录后积分不见了 —— 登录故障的自查步骤。

这一页对应 [console.beatra.ai](https://console.beatra.ai) 登录页上的三种常见故障，以及登录后进错账号的情况。
每一节的顺序就是建议的排查顺序：先做第一步，不行再做第二步。

> 只有绑定在同一个账号上的登录方式，进的才是同一个账号。微信扫码不行、想改用邮箱或手机验证码时，先确认它已经绑定在你的账号上：用从没绑定过的方式登录，会进另一个账号，积分和作品都不在那里。这台设备登录过原账号的话，登录页会先问你。详见[账号与合并](https://docs.beatra.ai/zh/docs/accounts)。

## 二维码加载不出来 [#qr-not-loading]

登录页里的二维码是从微信的 `open.weixin.qq.com` 直接加载的，不经过 Beatra。
所以它显示不出来，通常不是账号的问题，而是这一段网络没走通。

1. **先用页面上的「打开微信登录」。**
   二维码加载不出来时，它本来就顶在二维码的位置上。点它会跳到微信自己的授权页面，
   不再依赖内嵌的二维码，在公司网络和开了拦截插件的浏览器里成功率明显更高。
2. **关掉广告拦截 / 隐私保护插件后刷新。**
   uBlock、AdGuard、Brave 的 Shields 等会拦住从别的网站嵌进来的内容。二维码就是微信的网页嵌在登录页里的一块，所以会被拦住。
3. **换一个网络。**
   部分公司网络和校园网会屏蔽 `open.weixin.qq.com`。用手机热点试一次就能区分是网络问题还是别的问题。
4. **短时间内反复刷新登录页，会被临时限流。**
   同一条共用网络每小时能发起的扫码次数有上限。公司或学校里很多人走同一条网络时，算在一起。触发之后，二维码会一直空着，
   表现和「加载不出来」一模一样。等一小时，或者直接改用邮箱 / 手机验证码登录。

二维码本身有有效期。过期后它上面会盖一层「点击刷新」，点一下换一张新的即可。

## 验证码收不到 [#code-never-arrives]

1. **先等满 30 秒再点重发。** 邮件和短信都可能有几分钟延迟，反复点重发只会让每一封都排在更后面。
2. **翻垃圾邮件 / 订阅推广。** 企业邮箱的规则最严，第一封验证码进垃圾箱是最常见的情况。
   找到后把发件域名加进白名单，之后就不会再进了。
3. **确认邮箱拼写。** 验证码发到一个不存在的地址不会报错，页面只会告诉你「已发送」。
4. **手机号只支持中国大陆（+86）。** 其他国家和地区请用邮箱验证码或 Google 登录。
5. **提示「操作太频繁了」时，按它说的时间等。** 在这段等待里继续试，等待会更长。

## 扫码后卡住，或者提示登录失败 [#scan-stuck]

1. **先直接打开 [console.beatra.ai](https://console.beatra.ai)。**
   如果能进控制台，说明登录其实已经成功了，页面上的失败提示是过时的 —— 不用再登一次。
2. **提示「二维码已过期」。**
   一次扫码大约 10 分钟内有效。点「重新扫码」换一张新的。
3. **手机上确认了，网页却还停着。**
   确认之后，页面会显示「已在手机上确认」，然后是「正在进入 Beatra…」。如果它停住，多半是这个页面不再向服务器询问登录有没有完成（你切走了标签页，或者网络断了一下）。刷新登录页再看一次，通常会直接进控制台，因为授权已经完成了。如果还停着，点「仍在等待？重新扫码」。
4. **想换一个微信账号登录。**
   先在浏览器里退出当前账号，再扫码。已经登录的状态下扫新码，会被当成同一个人的重复授权。

## 登录后积分或作品不见了 [#wrong-account]

多半是进了另一个账号：用了一种没绑定在原账号上的登录方式，就会进另一个账号。

1. **看控制台顶部的账号名。** 钱包页的「充值到：…」也写着当前账号。
2. **不是原来的账号，就退出，用原账号的登录方式重新登录。** 登录页上的「上次登录：…」可以帮你认出原来的账号。
3. **确实有两个账号，就把它们合并。** 登录任意一个，在「设置 → 登录方式」里合并另一个，积分、作品和已连接的 Agent 都会在一起。见[合并两个账号](https://docs.beatra.ai/zh/docs/accounts#merge)。

## 还是进不去

带上这些信息发到 [support@beatra.ai](mailto:support@beatra.ai)：

- 你用的登录方式（微信 / 邮箱 / 手机 / Google）
- 页面上的原文提示
- 大概的时间和你所在的地区
- 邮箱或手机号（不要发验证码本身，验证码不该给任何人，包括我们）