07 玩家登录、快捷登录与绑定问题
这一章主要给管理处理玩家登录问题时使用。玩家经常会把“商城授权”“玩家账号登录”“QQ/微信快捷登录”“微信通知绑定”混在一起问，管理需要先分清是哪一类问题。
入口：
玩家前端 -> 登录 / 注册
玩家前端 -> 个人信息
商城后台 -> 快捷登录示例视频预留
这里后续可放“玩家登录和快捷登录绑定流程”的视频，例如：/mp4/newwebdoc/07-login-oauth.mp4
一、先分清三个概念
| 概念 | 影响范围 | 常见表现 |
|---|---|---|
| 商城授权 | 整个商城程序 | 所有人都被引导到授权/续费页面 |
| 玩家账号登录 | 单个玩家访问商城 | 打开充值、个人中心等页面跳回登录 |
| 快捷登录绑定 | QQ/微信/Steam 等第三方登录 | 第三方授权后还需要绑定 SteamID |
如果只有某个玩家进不去，通常是玩家登录问题。
如果所有人都进不去，优先检查商城授权、网站端口、数据库和后端是否启动。
二、哪些页面需要登录
除了登录、注册、授权等公开页面外，玩家端大多数页面都需要合法登录。
例如：
- 个人信息
- 充值
- 会员
- 商品购买
- 礼包领取
- 传送
- 云储仓库
- 通行证奖励
如果登录失效，会跳回登录页。
玩家可以这样理解：这是为了避免别人直接打开链接操作你的账号。
三、账号密码登录
玩家使用注册时的账号密码登录。登录成功后，浏览器会保存登录态。
常见问题：
| 玩家反馈 | 管理解释 |
|---|---|
| 用户不存在或密码错误 | 账号、密码或注册信息不匹配 |
| 登录一段时间又跳登录 | 登录态过期、浏览器清理 Cookie 或换设备 |
| 注册过但忘记账号 | 管理可按 SteamID 在玩家信息中辅助查询 |
建议玩家使用同一个浏览器，不要频繁清理 Cookie。
四、快捷登录是什么
快捷登录是让玩家用 QQ、微信、Steam 等第三方身份登录商城。
当前项目中，快捷登录是否显示取决于后台配置和当前域名。没有配置 APPID/APPKEY 或当前访问域名不匹配时，玩家前端可能不会显示对应按钮。
快捷登录首次授权后，通常需要绑定 SteamID。绑定后，下次就可以用第三方账号快速进入对应玩家账号。
五、为什么要绑定 SteamID
商城所有权益最终都要落到 SCUM 玩家 SteamID 上，例如：
- 商品发货
- 美金扣款
- 会员等级
- 礼包领取
- 通行证奖励
- 建家权限
- 微信通知
QQ/微信账号本身不能直接代表游戏角色，所以首次快捷登录需要绑定 SteamID。
六、未注册 SteamID 的绑定风险
有些玩家没有在网页主动注册，但已经进过服务器，系统可能已经根据在线玩家数据自动创建了账号。
为了避免玩家 A 用自己的 QQ/微信恶意绑定玩家 B 的 SteamID，后台可以开启在线校验或验证码流程：
- 玩家输入 17 位 SteamID。
- 系统要求该 SteamID 对应玩家在线。
- 页面生成验证码。
- 玩家在游戏聊天中发送验证码。
- 校验通过后完成绑定。
如果玩家问“为什么绑定还要我进游戏发验证码”，可以解释：这是为了证明你确实控制这个游戏角色，防止别人抢绑。
七、QQ/微信快捷登录常见问题
玩家说：QQ/微信登录按钮没有
管理检查：
- 后台快捷登录是否启用。
- 当前访问域名是否与第三方平台配置一致。
- APPID/APPKEY 是否填写。
- 前端是否刷新缓存。
玩家说：微信授权后提示回调地址不一致
这是第三方平台应用配置的回调地址与当前商城实际回调地址不一致。管理需要到快捷登录平台检查应用回调地址，保证协议、域名、路径完全一致。
示例差异也会导致失败：
http://example.com/callback
https://example.com/callback这两个不是同一个地址。
玩家说：快捷登录已经绑定其他 SteamID
说明这个 QQ/微信身份已经绑定过另一个 SteamID。管理不要直接让玩家重复绑定，应先确认玩家身份，再决定是否解绑或人工处理。
玩家说：Steam 登录按钮有时不显示
Steam 登录入口可能会做可用性探测。如果访问 Steam 相关服务延迟过高或不可用，前端可能隐藏入口，避免玩家点击后一直卡住。
八、微信通知绑定不是微信快捷登录
项目里还有一个“微信通知绑定”，通常在：
玩家前端 -> 个人信息 -> 绑定微信它的作用是让玩家接收微信通知，例如订单、发货、建家权限、开锁提醒等。
它和微信快捷登录不是同一件事：
| 功能 | 作用 |
|---|---|
| 微信快捷登录 | 用微信身份登录商城 |
| 微信通知绑定 | 用微信接收商城通知 |
玩家可能两个都需要，但管理解释时不要混淆。
九、玩家问答话术
问：为什么我打开充值页又回到登录？
答：充值页需要登录后才能访问。请先登录商城账号，如果刚登录过仍跳转，可能是浏览器 Cookie 被清理或登录态过期，重新登录即可。
问：为什么微信登录后还要绑定 SteamID？
答：微信只能证明你的微信身份，商城发货和会员权益都要绑定到游戏 SteamID。绑定是为了确保奖励发给正确的游戏角色。
问：为什么绑定 SteamID 要我进游戏发验证码？
答：这是防止别人用自己的微信抢绑你的 SteamID。只有能进入游戏并发送验证码的人，才能证明这个 SteamID 是自己的。
问：我支付成功但余额没变，是不是登录错账号？
答：有可能。请提供订单号、SteamID 和支付截图。管理会按订单绑定的 SteamID 查是否到账。
十、管理排障检查表
玩家登录或快捷登录出问题时，按这个顺序查：
- 网站是否所有人都打不开。
- 商城授权是否正常。
- 玩家账号密码是否正确。
- 玩家 SteamID 是否存在。
- 快捷登录后台是否启用。
- APPID/APPKEY 是否正确。
- 回调地址是否与当前域名一致。
- 是否开启在线校验或验证码。
- 第三方账号是否已绑定其他 SteamID。
示例视频预留
这里后续可放“快捷登录常见失败排查”的视频，例如：/mp4/newwebdoc/07-troubleshooting.mp4