merge: 同步 main 同名角色绑定修复
This commit is contained in:
@@ -91,14 +91,18 @@
|
||||
`existing_actionable_pending`;
|
||||
3. 没有扫码前 baseline:可确认,原因 `first_role_without_baseline`;
|
||||
4. 角色名与 baseline 不同:可确认,原因 `role_changed`;
|
||||
5. 角色名相同且 `bindAct=1`:已经绑定,不可重复确认;
|
||||
6. 同 alias 从 `bindAct=1` 转为 `bindAct=0 + needBindAct=1`:可确认,原因
|
||||
`same_alias_after_bound_transition`;
|
||||
7. 其他同名角色:视为旧残留,原因 `same_role_stale`。
|
||||
5. 角色名相同,但同 alias 仍返回 `needBindAct=1`:可确认,即使当前
|
||||
`bindAct=1`,原因 `same_alias_after_bound_transition`;
|
||||
6. 动作 alias 上 `bindAct=1 + needBindAct=1 + 同名角色`:可确认;
|
||||
7. 角色名相同且接口不再要求绑定:视为已经绑定,原因 `already_bound`;
|
||||
8. 其他同名角色:视为旧残留,原因 `same_role_stale`。
|
||||
|
||||
规则 2 是 2026-11-21 线上修复:动作 alias 已经存在同名 pending 时,它仍是可执行
|
||||
确认的 pending,不应因为“角色名没变化”一直灰掉确认按钮。
|
||||
|
||||
规则 5、6 解决“重新绑定同名角色”:业务不要求每次都必须选择一个不同的角色。
|
||||
只要官方动作 alias 仍要求绑定,同名角色也必须能进入确认流程。
|
||||
|
||||
### 完整流程
|
||||
|
||||
```text
|
||||
@@ -107,7 +111,9 @@
|
||||
-> 找动作 alias 上的可确认 pending
|
||||
-> 生成二维码
|
||||
-> 持久化 baseline、候选来源、判定原因
|
||||
-> binding_poll 每次只查一次角色
|
||||
-> binding_poll 每轮先查 legacy(cjm)
|
||||
-> 角色/状态变化、每 3 轮或最后一轮再补查动作 alias(QYOOB)
|
||||
-> 官方直接返回 bindAct=1 时立即结束为 confirmed
|
||||
-> 找到确认条件:任务 success + bind_ready_for_confirm=true
|
||||
-> actBind
|
||||
-> 回查 bindAct=1
|
||||
@@ -115,7 +121,20 @@
|
||||
```
|
||||
|
||||
二维码任务不能在 worker 内长时间阻塞;出码后写 `binding_poll`、`next_run_at` 和
|
||||
`run_deadline_at`,由数据库调度器继续轮询。
|
||||
`run_deadline_at`,由数据库调度器继续轮询。轮询窗口为 20 分钟,平台展示的二维码
|
||||
TTL 为 21 分钟,留 1 分钟收尾余量。
|
||||
|
||||
轮询间隔按任务生命周期退避:
|
||||
|
||||
| 已等待时间 | 间隔 |
|
||||
| --- | --- |
|
||||
| 0-2 分钟 | 5 秒 |
|
||||
| 2-10 分钟 | 10 秒 |
|
||||
| 10-20 分钟 | 20 秒 |
|
||||
|
||||
`binding_poll` 有 6 个独立执行槽,但不会每轮同时请求所有 alias。生产常态是每轮
|
||||
只查 `cjm`,动作 alias 仅在 legacy 状态变化、每 3 轮巡检和最后一轮补查。这样既能
|
||||
承接十几个客服并发扫码,也不会把几十个二维码放大成持续的双倍官方请求。
|
||||
|
||||
### 确认前保护
|
||||
|
||||
@@ -155,6 +174,20 @@
|
||||
- `pending_role_name`
|
||||
- `bind_summary`
|
||||
|
||||
### 角色接口原始响应留档
|
||||
|
||||
关键角色接口的原始响应写入 `douyu_role_api_logs`,用于还原不同 alias 在
|
||||
扫码、待确认、确认和回查各阶段到底返回了什么。记录内容:
|
||||
|
||||
- 账号、任务、作用域、阶段和 alias;
|
||||
- `role_name`、`bindAct`、`bindRole`、`needBindAct`、`needBindRole`、
|
||||
换绑倒计时和可换绑时间;
|
||||
- 请求摘要与原始响应 JSON;
|
||||
- 入库前的 Cookie、token、CSRF 等敏感键脱敏结果。
|
||||
|
||||
轮询不会把相同响应每 5 秒重复入库,只在 legacy 状态变化、动作 alias 响应变化、
|
||||
二维码预检、确认前、确认接口返回和确认后回查时写入。
|
||||
|
||||
建议的生产只读查询:
|
||||
|
||||
```sql
|
||||
@@ -168,6 +201,18 @@ ORDER BY id DESC
|
||||
LIMIT 20;
|
||||
```
|
||||
|
||||
角色接口原始响应查询:
|
||||
|
||||
```sql
|
||||
SELECT id, task_id, stage, act_alias, role_name,
|
||||
is_bound_act, need_bind_act, change_role_wait_time,
|
||||
response_json, created_at
|
||||
FROM douyu_role_api_logs
|
||||
WHERE account_id = ?
|
||||
ORDER BY id DESC
|
||||
LIMIT 100;
|
||||
```
|
||||
|
||||
日志检索:
|
||||
|
||||
```bash
|
||||
@@ -240,11 +285,32 @@ docker compose logs douyu-login | grep '确认前状态'
|
||||
回归:`tests/test_douyu_binding_state.py`、`tests/test_douyu_account_probe.py`、
|
||||
`tests/test_douyu_task_concurrency.py`。
|
||||
|
||||
### 2026-11-21:扫码成功但轮询超时、确认按钮不稳定
|
||||
|
||||
生产失败任务中大量出现 `role_timeout`,但 `result` 实际已经带回角色,且部分
|
||||
`bindAct=1`。原因是 10 分钟轮询窗口偏短、每轮无条件查两个 alias,以及只把
|
||||
`bindAct=0 + bindRole=1` 当成功。
|
||||
|
||||
修复:轮询窗口延长到 20 分钟;分阶段退避;legacy 每轮查询、动作 alias 按变化/
|
||||
周期/末轮补查;直接 `bindAct=1` 立即收敛;前端自动轮询期间仍允许“立即查询角色”;
|
||||
关键接口响应进入 `douyu_role_api_logs`。
|
||||
|
||||
### 2026-11-21:同名角色被误判为已经绑定
|
||||
|
||||
生产接口留档显示,活动 alias 可以同时返回 `bindAct=1`、`needBindAct=1` 和与上次
|
||||
相同的角色名。旧判定先看 `bindAct=1` 并直接返回 `already_bound`,导致用户重新
|
||||
绑定同名角色时任务一直等待。
|
||||
|
||||
修复:只要动作 alias 仍返回 `needBindAct=1`,同名角色也进入可确认状态;候选选择
|
||||
仍先选真正变化的新角色,再选择同名可确认角色,避免活动 alias 的旧快照压掉
|
||||
`cjm` 上的新角色。
|
||||
|
||||
### 历史固定规则
|
||||
|
||||
- 不要把 `bindRole=1` 当成已绑定;
|
||||
- 不要把未确认时的换绑倒计时当成冷却;
|
||||
- 不要用 `cjm` 的旧角色覆盖活动 alias pending;
|
||||
- 不要要求每次绑定都必须换一个不同的角色,同名重绑是正常流程;
|
||||
- 不要在页面层重新实现 `bindAct/needBindAct` 判断;
|
||||
- 不要把原始 `bind_summary` 当业务文案,它只用于排障。
|
||||
|
||||
@@ -254,3 +320,4 @@ docker compose logs douyu-login | grep '确认前状态'
|
||||
| --- | --- |
|
||||
| 2026-11-21 | 建立斗鱼协议总览;补充多 alias 职责、pending 真值表、结构化判定日志和同名 pending 修复记录 |
|
||||
| 2026-11-21 | 补充 `storehome` 单账号全量商品资格、`storedetail`/`batchExchangeLimit` 边界和抓包证据入口 |
|
||||
| 2026-11-21 | 补充同名重绑、轮询退避、直接绑定识别和角色接口原始响应留档 |
|
||||
|
||||
Reference in New Issue
Block a user