fix(douyu): 稳定绑定轮询并留档角色接口响应
This commit is contained in:
@@ -104,7 +104,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
|
||||
@@ -112,7 +114,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 轮巡检和最后一轮补查。这样既能
|
||||
承接十几个客服并发扫码,也不会把几十个二维码放大成持续的双倍官方请求。
|
||||
|
||||
### 确认前保护
|
||||
|
||||
@@ -152,6 +167,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
|
||||
@@ -165,6 +194,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
|
||||
@@ -231,6 +272,16 @@ 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`。
|
||||
|
||||
### 历史固定规则
|
||||
|
||||
- 不要把 `bindRole=1` 当成已绑定;
|
||||
@@ -243,4 +294,4 @@ docker compose logs douyu-login | grep '确认前状态'
|
||||
|
||||
| 日期 | 变更 |
|
||||
| --- | --- |
|
||||
| 2026-11-21 | 建立斗鱼协议总览;补充多 alias 职责、pending 真值表、结构化判定日志和同名 pending 修复记录 |
|
||||
| 2026-11-21 | 建立斗鱼协议总览;补充多 alias 职责、pending 真值表、结构化判定日志、轮询退避、直接绑定识别和角色接口原始响应留档 |
|
||||
|
||||
Reference in New Issue
Block a user