fix(douyu): 支持同名角色重新绑定

This commit is contained in:
yml
2026-11-21 22:44:01 +08:00
parent 2c11a784d2
commit 140e6fa4c3
6 changed files with 172 additions and 32 deletions
+20 -5
View File
@@ -88,14 +88,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
@@ -282,11 +286,22 @@ docker compose logs douyu-login | grep '确认前状态'
周期/末轮补查;直接 `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` 当业务文案,它只用于排障。
@@ -294,4 +309,4 @@ docker compose logs douyu-login | grep '确认前状态'
| 日期 | 变更 |
| --- | --- |
| 2026-11-21 | 建立斗鱼协议总览;补充多 alias 职责、pending 真值表、结构化判定日志、轮询退避、直接绑定识别和角色接口原始响应留档 |
| 2026-11-21 | 建立斗鱼协议总览;补充多 alias 职责、pending 真值表、同名重绑、结构化判定日志、轮询退避、直接绑定识别和角色接口原始响应留档 |