Skip to content

feat(subscriptions): 绑定时自动启用手动禁用的 OAuth 渠道,释放时恢复禁用;Codex OAuth 失败显示错误码 (HQ-Task T261113-10) - #43

Merged
AdoreJc merged 2 commits into
fork-mainfrom
hq/T261113-10-bind-enable-disabled-channel
Nov 14, 2026
Merged

AdoreJc merged 2 commits into
fork-mainfrom
hq/T261113-10-bind-enable-disabled-channel

Conversation

@AdoreJc

@AdoreJc AdoreJc commented Nov 14, 2026

Copy link
Copy Markdown
Owner

HQ-Task: T261113-10

本 PR 由 AI(Claude Code)生成,提交者不是本仓库历史核心开发者。

Agent

  • Tool: Claude Code(桌面版 Code 标签页,由 Project HQ 会话派发的子会话)
  • Tool version: Claude Agent SDK(桌面版内置)
  • Model (full id): claude-fable-5-2
  • Host (CLI / IDE / GitHub coding agent / other): Claude 桌面版,Windows 10 worktree;完整测试、三库与端到端在 tailnet 测试机(macOS arm64)的临时容器
  • Date (UTC): 2026-11-14

Links

User request

  • Verbatim: (HQ brief 转述)“站长有一类订阅 OAuth 渠道(Claude type 64 / Codex)只想给某一个用户用,不想让它在任何时候进入公共池。打算的用法是:渠道建好后直接手动禁用停放着;把它绑定到某个用户的订阅时自动启用;解绑、换绑或订阅到期释放时自动回到禁用。……另外,这类渠道授权失效时很难排查:Codex 换码失败只记了 HTTP 状态码,手动刷新失败时界面只显示一句通用文案,看不到 OAuth 错误码。”
  • Later constraints or corrections from the user (quote, or none): (HQ)“语义是‘释放时恢复绑定前的状态’,不是‘释放一律禁用’。绑定前就启用着的渠道,行为必须与现在完全一致。”“locale 文件只追加本任务的新 key,不重排、不改动已有 key 和转义。”“不记录也不返回授权码、token、响应体原文。”

Out of scope — refuse

  • Matched: no。fork 内部 PR(目标 fork-main);不改 Codex 渠道类型、转发协议或透传,只改订阅绑定时的渠道状态和管理端的错误提示。
  • If yes, what was told to the user: 不适用

Open gate — do not open unless all are satisfied

  • Out of scope (including pass-through-only forwarding): no
  • Usage / configuration / integration (answered instead of opening): no
  • Required issue facts present without invention: yes
  • Verification is actual commands or steps and observed results, not only go build or tests passed: yes
  • Body is short and factual; no unfiltered AI-generated text: yes
  • Open: yes
  • If no, what was told to the user (stop here): 不适用

Kind

  • Bug fix
  • New feature
  • Performance / refactor
  • Docs
  • Other:

Issue facts

  • Actual behavior: 绑定只改渠道分组不改状态,手动禁用的渠道绑上后仍不可用;释放后渠道保持启用并回到原分组。Codex 换码失败只有 HTTP 状态码,手动刷新失败只有通用文案。
  • Impact: 只给单个用户用的 OAuth 账号无法“停放”,释放后会回到公共池;授权失效时管理员看不到原因。
  • Frequency: 每次绑定/释放手动禁用的渠道;每次换码或刷新失败。
  • Evidence that the problem is in new-api rather than the client or upstream: model/subscription_channel_binding.go 的绑定/释放只调用 setChannelGroupTx;service/codex_oauth.go 换码失败只返回 status=%d。
  • Applicable types and their fields: deployment —— user_subscriptions 新增一列(见下);frontend —— 绑定对话框一条提示;relay / billing 不适用。

Change

A. 绑定/释放时的渠道状态

  • user_subscriptions.bound_channel_prev_status(int,默认 0,随 AutoMigrate 添加):值为 2 表示“绑定前是手动禁用,绑定时已启用,释放时改回”。
  • bindSubscriptionChannelTx:渠道为手动禁用时在同一事务里改为启用并写标记;自动禁用不改状态,返回的提示说明需重新授权后手动启用;已启用的不记录。绑定到仍停放在专属组里的渠道时,沿用上一个(已结束)绑定的标记。
  • releaseBoundChannelTx(解绑、换绑释放旧渠道、取消、删除):有标记时恢复分组的同时改回手动禁用(当前是启用或自动禁用都改);管理员已把渠道移出专属组时仍然不动渠道。
  • ExpireDueSubscriptions:订阅自然到期原本就不调用 releaseBoundChannelTx(渠道留在专属组,由既有测试固定)。这里只加一步:有标记的把渠道改回手动禁用并清标记,分组与绑定引用照旧。
  • 状态与分组在 setChannelGroupTx 里一次写入(含 status_reason/status_time),随后用现有的 Channel.UpdateAbilities(tx) 重建 abilities,提交后用现有的 InitChannelCache() 刷新缓存;启用时与 UpdateChannelStatus 一样清 Codex 冷却。
  • 两处 default 回落未改。

B. Codex OAuth 错误码

  • 换码失败解析响应体的 error / error.code,返回 *CodexOAuthExchangeError(状态码 + 错误码);描述里若出现发送的 code 或 verifier 则丢弃。
  • 已被永久拒绝的 refresh token 的本地短路改为类型化错误 *CodexRefreshTokenRejectedError(文本不变)。
  • RefreshCodexChannelCredential 与 ExchangeCodexOAuth 失败时,若有 OAuth 错误码则在消息里带出,并在响应顶层加 oauth_error_code(刷新另有 reauthorization_required);超时、网络错误、非 JSON 响应保持原通用文案。只返回错误码,不返回上游描述、授权码、token。

Research

Duplicate / prior art

Docs and code

  • https://docs.newapi.ai/ : 未查。订阅绑定 OAuth 渠道与 Codex OAuth 向导是本 fork 自有功能,上游文档没有对应内容。
  • https://deepwiki.com/QuantumNous/new-api : 未查,同上。
  • README / repo docs: AGENTS.md、web/AGENTS.md。
  • Code paths and what they imply for this change: model/channel.go UpdateChannelStatus 不是事务内写法(自己取锁、先改缓存、用全局 DB),不能在绑定事务里调用,所以在事务里写状态列并复用 UpdateAbilities(tx) 与 InitChannelCache();model/ability.go 的 UpdateAbilities 按 channel.Status 生成 enabled。

Alternatives considered

  • Option A: 释放时一律禁用。会改变绑定前已启用渠道的行为,与要求不符。
  • Option B: 提交后调用 UpdateChannelStatus。状态与分组不在同一事务,失败时会出现“已绑定但仍禁用”。
  • Why this approach: 一列标记即可表达“恢复绑定前状态”,没有标记的路径与原先逐行一致。

Files

Path Why
model/subscription.go 新列;到期时按标记禁用渠道
model/subscription_channel_binding.go 绑定启用、释放恢复、提示文案
service/codex_oauth.go 换码错误解析;CodexOAuthErrorCode
service/codex_credential_refresh.go 短路错误改为类型化(1 行)
controller/channel.go、controller/codex_oauth.go 失败响应带错误码
web/src/features/subscriptions/... 绑定对话框提示及其判定函数
web/src/i18n/locales/*.json 7 个新 key × 7 个语言,只追加
model/subscription_channel_binding_test.go、controller/codex_oauth_test.go、web/.../__tests__/channel-binding.test.ts 测试(未新增测试文件)

Behavior

  • Before: 见 Issue facts。
  • After: 手动禁用的渠道绑定即启用、释放即恢复手动禁用;绑定前启用的渠道全程不变;自动禁用的渠道绑定后仍为自动禁用并有提示。刷新/换码失败的提示里有 OAuth 错误码。
  • Explicit non-goals / leftover work: 不改 Claude OAuth 侧的同类错误提示;不改后台刷新任务的筛选条件;不改 default 回落。

Verification

  • Commands and results:
    • macOS arm64,Go 1.26.10:GOWORK=off go test ./model/... ./controller/... ./service/... -count=1 → 7 个包全部 ok。
    • 同机带 TEST_MYSQL_DSN(MySQL 8.4.13)与 TEST_POSTGRES_DSN(PostgreSQL 17.11):go test ./model/... -count=1 -v → 463 PASS、0 FAIL、5 SKIP(均为既有的 TestCostAccountingDatabaseMatrix 子项),其中 mysql/postgres 子测试 54 个通过。
    • Windows 本机:./model/...、./service/... 通过;./controller/... 是已知的 audit.db 临时目录清理失败并拖到 10 分钟超时,与本改动无关(同一包在 macOS 上 ok 42s)。
    • 新测试对旧代码:把 6 个生产文件换回 fork-main(仅补上结构体字段和函数签名以便编译)后,TestBindEnablesManuallyDisabledChannel…(8 个子测试)、TestBindLeavesAutoDisabledChannel…、TestExchangeCodexOAuthReports…、TestRefreshCodexChannelCredentialReports… 失败;回归用的 TestBindLeavesEnabledChannelStatusAlone… 在旧代码上通过。
    • 前端(Bun 1.4.4):bun run typecheck → 0 错误;bun run test → 243 个文件 2715 个用例通过;bun run build 成功;oxlint src/features/subscriptions 报 3 个错误,都在本 PR 未改动的既有文件里。
  • Manual steps and observed result(测试机,全新的容器/端口/数据目录,上游为 mock:HTTP 的 Codex responses 端点 + 以测试 CA 签发、经容器网络别名接管 auth.openai.com 的 token 端点;实例开 MEMORY_CACHE_ENABLED=true、SYNC_FREQUENCY=3600,所以下列结果不依赖定时同步)。同一流程在 SQLite、MySQL 8.4.13、PostgreSQL 17.11 上各跑“空库新建”和“从 09cca3d 升级”,六次结果一致:
    • 绑定前:渠道 status=2 group=default;用户 A 请求 503 No available channel for model gpt-5 under group default。
    • 绑定:返回 …The channel was manually disabled and has been enabled; it will be disabled again when the binding is released;渠道立即 status=1 group=codex-ch1;A 请求 200,正文 pong from mock。
    • 用户 B:默认分组令牌 503 No available channel…;分组设为 codex-ch1 的令牌 403 The subscription dedicated group codex-ch1 of this token is no longer available…。
    • 解绑:渠道立即 status=2 group=default;A 请求 503。
    • 再次绑定后手动刷新:token 端点答 400 invalid_client → {"message":"Failed to refresh credentials: OpenAI returned the error invalid_client","oauth_error_code":"invalid_client","reauthorization_required":false,"success":false};答 401 refresh_token_invalidated → {"message":"OpenAI rejected the refresh token (refresh_token_invalidated). Authorize the account again","oauth_error_code":"refresh_token_invalidated","reauthorization_required":true,"success":false},再点一次(本地短路,mock 未再收到请求)返回相同内容;渠道变为 status=3。
    • 授权向导换码,token 端点答 400 invalid_grant → {"message":"Authorization code exchange failed: OpenAI returned the error invalid_grant. Generate a new authorization link and try again","oauth_error_code":"invalid_grant","success":false},响应里不含授权码。
    • 取消订阅(此时渠道为自动禁用):渠道 status=2 group=default。
    • mock 进程中途崩溃的一次:刷新返回原通用文案 Failed to refresh credentials. Please try again later(网络错误不带错误码)。
  • 迁移:
    • 空库首次启动后新列:SQLite bound_channel_prev_status INTEGER default 0;MySQL bigint default 0;PostgreSQL bigint default 0。
    • 升级:用 new-api-fork:fork-main-09cca3d97-arm64 建库,再用 09cca3d 的代码写入用户、渠道、订阅和一条已启用渠道的绑定;换新镜像启动后新增该列,原有 4 个 bound_* 列、索引列表与 3 行订阅不变,已有绑定行的新列为 0;再启动一次列与数据不变,启动日志无迁移错误。升级前就存在的绑定在新版本下解绑:渠道保持 status=1 并回到 default。
  • UI: 无截图,未在浏览器里看绑定对话框;提示的判定逻辑有单元测试,typecheck 与 build 通过。
  • Tests added or updated, or why none: 见 Files。
  • Databases / providers / platforms exercised: SQLite(内置驱动)、MySQL 8.4.13、PostgreSQL 17.11;macOS arm64 原生与 linux/arm64 容器;Windows 10(部分)。未覆盖最低支持版本(MySQL 5.7.8、PostgreSQL 9.6),本改动只加一个整型列,不依赖版本特性。
  • Not verified: 浏览器中的对话框与向导界面;真实 ChatGPT/Claude 账号(按要求全部 mock);Claude type 64 渠道的端到端(只有单元测试覆盖);多节点部署下其他节点的渠道缓存(与现有分组变更一样靠各节点定时同步);绑定逻辑的单元测试只在 SQLite 上跑,MySQL/PG 由上面的端到端覆盖。测试容器、网络、镜像、数据目录已全部删除。

Risks

  • Failure modes: 标记只在绑定时写、释放或到期时清;绑定期间管理员手动改渠道状态不会改标记,所以带标记的渠道释放后一律回到手动禁用,不带标记的渠道释放时状态不动。到期路径每个用户多一次查询(只查带标记的到期订阅)。
  • Billing / quota / auth impact: 不涉及计费与分发逻辑。错误响应只多了 OAuth 错误码;上游描述仍只进服务器日志(刷新路径沿用既有行为)。参照 OWASP ASVS 5.0 V16(日志与错误处理):错误信息不含凭据。
  • Follow-ups: Claude OAuth 侧同类错误码提示(T261112-10 范围);编辑表单里有未保存的新凭证时点“刷新凭证”会用库里的旧凭证。

Scope check

  • Single focused change: no —— 按 HQ brief 把 A(绑定状态)与 B(错误码)放在同一个任务里。
  • Secrets included: no
  • Out of scope (Coding Plan / reverse-engineered channel / third-party wrapper / Codex / pass-through-only forwarding): no

🤖 Generated with Claude Code

…码 (HQ-Task T261113-10)

A. 订阅绑定 Claude OAuth / Codex 渠道时,手动禁用的渠道在同一事务里启用,
   并在订阅上记下 bound_channel_prev_status;解绑、换绑、取消、删除时按该标记
   把渠道改回手动禁用,订阅到期时在专属组内改回禁用。绑定前已启用的渠道行为不变;
   自动禁用的渠道不改状态,只在提示里说明需重新授权。
B. Codex 换码与手动刷新失败时解析 OAuth 错误码并返回前端(oauth_error_code、
   reauthorization_required),不返回授权码、token 或响应体。

Co-Authored-By: Claude Fable 5.2 <noreply@anthropic.com>
@AdoreJc

AdoreJc commented Nov 14, 2026

Copy link
Copy Markdown
Owner Author

HQ-Review R1 @ 847436b: APPROVE

结论:A、B 两部分都按 brief 实现。绑定前已启用的渠道,代码路径与旧代码一致(setChannelGroupTx 在 status=0 时只写 group 并重建 abilities)。新测试覆盖了解绑、换绑、作废、删除、到期、续订早于到期扫描、管理员中途移出专属组、自动禁用这几种情况,并且断言的是渠道状态、分组和 abilities 这些可观察结果。错误码只放行 [A-Za-z0-9_.-]{1,64},不会注入标记;响应里没有授权码、token 和上游描述。以下各条都不阻塞合并。

  1. model/subscription_channel_binding.go:277-296 与 model/subscription.go:1230-1240(不阻塞,建议修)到期扫描用的是不加锁读到的订阅快照。Find(&enabledBindings) 之后,disableExpiredBoundChannelTx 先按 id 无条件清标记,再锁渠道,然后用内存里旧的 BoundChannelId/BoundGroup 去判断。失败场景:订阅 S1 已过期但还没被扫描;扫描事务执行完 Find 后,管理员恰好把续订 S2 绑到同一渠道并提交(这会清掉 S1 的 bound_channel_id,S2 记下标记,渠道保持启用);扫描接着锁住渠道,看到它仍在同一个专属组且处于启用状态,于是把它改成手动禁用。结果是 S2 的绑定还在生效,渠道却被禁用,用户收到 503。这个结果是“失败即关闭”,没有暴露风险,时间窗口也很窄。另外,两边加锁顺序相反(扫描先锁 S1 行再锁渠道,绑定先锁渠道再更新 S1 行),在 MySQL/PG 上可能互相死锁,其中一方报错。建议:把清标记改成条件更新 WHERE id=? AND bound_channel_id=? AND bound_channel_prev_status=2,RowsAffected==0 时直接跳过;或者先锁渠道,再加锁重新读订阅。

  2. model/subscription_channel_binding.go:216-236(不阻塞,记录)状态写入没有复用 UpdateChannelStatus。PR 里给的理由(那个函数不在事务里执行)成立,但这样就绕过了 channelStatusLock 和每渠道的 polling lock。失败场景:释放事务提交前,一次请求失败触发了 UpdateChannelStatus(自动禁用) 并读到了 status=1;释放提交之后,saveStatusState 无条件写入 status=3,覆盖掉刚恢复的手动禁用,而此时渠道已经回到原分组或 default。如果开启了自动启用,渠道之后可能在公共组里被重新启用。旧代码在释放时直接把启用的渠道放进 default,所以本 PR 仍然比旧代码好。要彻底解决,需要在 UpdateChannelStatus 里做条件写入,这超出了本 PR 的范围,建议另开后续任务。

  3. 测试缺口(不阻塞):

    • 到期路径缺两种情况:“管理员已把渠道移出专属组”和“渠道已被删除”。代码里有这两个分支(disableExpiredBoundChannelTx 的 group 判断和 NotFound 判断),但没有测试。
    • 没有对第 1 条竞态的测试。
    • 绑定逻辑的单元测试只在 SQLite 上跑;MySQL/PG 只靠端到端验证。
  4. 设计提示(不阻塞,属于 brief 的取舍):渠道绑定时是自动禁用,管理员按提示重新授权并手动启用后,释放时因为没有标记,会照旧以启用状态回到原分组(可能是 default)。这与 brief 第 2 条“没有标记:与现状完全一致”相符,但和“永不进入公共池”的目标有出入,供主管决定要不要另立任务。

  5. 范围:service/codex_credential_refresh.go 的 1 行改动,是把本地短路错误改成类型化错误,让第二次点击也能带出错误码,属于必要的最小改动。controller/codex_oauth.go 是换码的处理函数,属于 brief B.3 的范围。没有碰 Claude OAuth 服务、promptaudit、计费、distributor 或后台刷新任务的筛选条件。7 个 locale 只在末尾追加了 7 个 key(另有 1 行补逗号)。

  6. 迁移:新列是 int + default:0,走 AutoMigrate(UserSubscription 已在迁移列表里)。从 09cca3d 升级后,已有绑定行的值为 0,行为与旧代码一致。PR 描述里贴出了三库空库新建和升级的实测结果,我没有在本地复现。

到期扫描原先用未加锁读到的订阅快照去禁用渠道,并先写订阅行再锁渠道。
现在每个带标记的到期绑定单独开事务:先锁渠道,再在锁下重读订阅,
确认它仍指向该渠道且标记仍在才禁用;不再锁或写订阅行,
与绑定(渠道→订阅)和释放(订阅→渠道)都不会形成相反的加锁顺序。
到期后标记留在已结束的订阅上,续订重新绑定时沿用。

补测试:扫描快照之后续订绑定同一渠道(SQLite/MySQL/PostgreSQL 矩阵)、
到期时渠道已被移出专属组、到期时渠道已删除。

Co-Authored-By: Claude Fable 5.2 <noreply@anthropic.com>
@AdoreJc

AdoreJc commented Nov 14, 2026

Copy link
Copy Markdown
Owner Author

回复 HQ-Review R1 @ 847436b(实施会话,AI 生成)。新 head:88967fae0。

1. 到期扫描竞态与锁顺序 —— 已修,88967fae0

  • 改法:每个带标记的到期绑定单独开一个事务,第一条语句就是锁渠道行;在渠道锁下重读该订阅,确认 bound_channel_id 仍是这个渠道、标记仍为 2、渠道仍在它的专属组里,才把渠道改成手动禁用。不再锁、也不再写订阅行(到期时不清标记了,标记留在已结束的订阅上,续订重新绑定时沿用——这条沿用逻辑原本就有)。
  • 为什么没用建议里的条件更新:条件更新要写订阅行。绑定是“先锁渠道、再改指向该渠道的其他订阅”,解绑/作废/删除是“先锁订阅、再锁渠道”,扫描只要同时持有“渠道锁 + 某个订阅行锁”,就必然和其中一方顺序相反。所以选了“先锁渠道再重读”,并且重读用普通读、不写订阅,扫描在这一步只持有渠道一把锁,和两边都不会成环。
  • 重读能看到续订的前提:绑定只在持有渠道锁时改写其他订阅,所以拿到渠道锁之后订阅的归属是稳定的;事务在锁渠道之前没有任何普通读(MySQL 可重复读的视图在第一次普通读时建立),因此单独开事务。这一点写进了函数注释。
  • 行为变化仅限到期路径:禁用渠道的事务先于“标记订阅为 expired”的事务提交。若后者失败,下一轮扫描会再次进入,此时渠道已是手动禁用,直接跳过。

3. 测试缺口 —— 补了三项,88967fae0

  • TestExpirySweepLeavesChannelReboundToARenewalDatabaseMatrix(SQLite / MySQL / PostgreSQL):扫描读到快照之后续订绑定同一渠道,断言渠道保持启用、abilities 启用、续订的标记还在;MySQL/PG 上续订是在扫描事务已开启之后才绑定并提交的。
  • 到期时渠道已被管理员移出专属组:渠道不变。
  • 到期时渠道已删除:只把订阅标为 expired,不报错。
  • 绑定逻辑其余单元测试仍只在 SQLite 上跑(包内 TestMain 固定),没有在本次改动里扩成矩阵。

验证(测试机 macOS arm64,Go 1.26.10,临时容器 MySQL 8.4.13 / PostgreSQL 17.11,跑完已删除):

  • 【实测】新测试对修复前的代码(生产文件取 847436b):sqlite、mysql、postgres 三个子测试全部 FAIL,渠道被改成 Status:2、abilities 关闭。
  • 【实测】88967fae0:三个子测试 PASS;带两个 DSN 跑 go test ./model/... -count=1 -v → 469 PASS / 0 FAIL / 5 SKIP(既有的 TestCostAccountingDatabaseMatrix 子项),mysql/postgres 子测试 56 个通过;不带 DSN 跑 ./model/... ./controller/... ./service/... 7 个包全 ok。
  • 【推断】“不会死锁”来自加锁顺序分析(扫描在禁用渠道时只持有渠道锁),没有做多连接并发压测去证明。测试里的交错是确定性的单次交错,不是随机并发。

2. 状态写入绕过 channelStatusLock / polling lock —— 本 PR 未改,留待主管决定是否另开任务(需要在 UpdateChannelStatus 里做条件写入)。

4. 自动禁用渠道重新授权并手动启用后,释放时以启用状态回到原分组 —— 本 PR 未改,属 brief 的取舍,留待主管决定。

5、6 无需改动。

@AdoreJc

AdoreJc commented Nov 14, 2026

Copy link
Copy Markdown
Owner Author

HQ-Review R2 @ 88967fa: APPROVE

范围:只审 847436b..88967fa 这一个提交(model/subscription.go、model/subscription_channel_binding.go、对应测试)。R1 已 APPROVE 的部分没有重审。

R1 各条状态

竞态与加锁顺序(逐个交错推演)

  • 包含 lockForUpdate 且同时涉及渠道和订阅的路径,我逐个看了:绑定/换绑(先锁自己的订阅,再锁新渠道,再改指向该渠道的其他订阅,然后释放旧渠道)、解绑/作废/删除(先锁订阅,再锁渠道)、到期扫描(现在只锁渠道,订阅用普通读,不加锁也不写)。扫描在任何时候只持有一把渠道锁,并且不会去等订阅行锁:MySQL/PG 的普通读是 MVCC,不会被行锁阻塞。所以它和另外两条路径之间形成不了环。“不会死锁”这个推断,在订阅行锁和渠道行锁这一层是成立的。剩下的风险是 UpdateAbilities 在 MySQL RR 下可能因为 abilities 表的间隙锁死锁,但这一点在绑定/释放路径上本来就存在,不是本提交引入的;而且扫描现在一个事务只处理一个渠道,持锁范围比原来小。model_meta.go:321 会按 id 顺序锁住全部渠道,但它不碰订阅,也成不了环。
  • 交错 1:绑定先拿到渠道锁并提交(S1 的 bound_channel_id 被清成 0)→ 扫描再拿到渠道锁 → 普通读 S1 发现已不指向该渠道 → 跳过。MySQL RR 的读视图在第一次普通读时才建立,SELECT ... FOR UPDATE 读的是最新提交版本,扫描事务在锁渠道之前没有做任何普通读(每个绑定单独开事务),所以重读能看到绑定的提交。PG 默认 RC,每条语句都用新快照,同样能看到。
  • 交错 2:扫描先拿到渠道锁 → 绑定在锁渠道处等待 → 扫描把渠道禁用并提交 → 绑定看到渠道是手动禁用,把它重新启用,同时记下标记。最终状态正确。
  • 交错 3:解绑/删除 S1 与扫描并发,不管谁先拿到渠道锁,最终渠道都是“手动禁用”,分组由释放路径决定。删除时重读 Find 返回 0 行,BoundChannelId=0,跳过。
  • SQLite:lockForUpdate 是空操作。扫描事务里读渠道和读订阅用的是同一个快照;如果有绑定在快照之后提交,扫描写入时会收到 BUSY 错误,不会静默覆盖。这种情况下报错,下一轮扫描会重试。

重读条件

  • 重读检查了三项:bound_channel_id 是否仍是这个渠道、标记是否仍为 2、渠道是否仍在该订阅的专属组。任何一项不满足就什么都不做。没有重新检查 status='active' 和 end_time<=now。我核对过,这样可以接受:全仓库只有作废会改写 end_time,而且是改小,作废同时会清掉绑定;没有任何路径会原地延长订阅;扫描只在 master 节点上跑,并且有 subscriptionResetRunning 防重入,不会有两个扫描同时处理同一订阅。

回归

  • 绑定前就启用的渠道没有标记,扫描查询要求 bound_channel_prev_status = 2,所以它们根本不会进入这条路径,行为不变。releaseBoundChannelTx、clearSubscriptionChannelBindingTx、绑定、解绑在本提交里一行没改。

测试

  • TestExpirySweepLeavesChannelReboundToARenewalDatabaseMatrix 用旧代码跑会失败:旧代码拿快照判断,渠道仍在专属组且是启用状态,于是禁用它,assert.False(disabled) 和渠道状态断言都会失败。实施者贴出了三库在旧代码上 FAIL 的实测结果。断言的是渠道状态、分组、abilities 和续订的标记,都是可观察的状态。在 MySQL/PG 上,续订是在扫描事务已经 BEGIN、还没执行任何语句时绑定并提交的,正好覆盖上面说的读视图时机。没有覆盖交错 2(扫描先持锁、绑定在等),这个交错的结果靠推演得出,不阻塞。
  • 两个到期分支的测试(移出专属组、渠道已删除)在旧代码上也会通过。它们补的是 R1 feat(subscription): bind an OAuth channel account to a user subscription (HQ-Task T261105-02) #3 指出的覆盖缺口,不是复现 bug 的测试,这样合理。

发现(都不阻塞)

  1. model/subscription.go:1237-1249(不阻塞)原来是一个事务,现在拆成每个绑定一个事务,部分失败时缓存不会刷新。失败场景:同一用户有两条带标记的到期绑定,第一条的禁用已经提交,第二条的事务报错,函数在 1244 行直接 return,没有走到 1247 行的 InitChannelCache()。下一轮扫描时第一条渠道已经是手动禁用,返回 disabled=false,也不会刷新缓存。结果是内存里的渠道缓存一直显示启用,要等定时同步才更新。影响有限:这个渠道在专属组里,对应的订阅已经过期,路由不会选到它,也不会暴露到公共池。建议在出错返回之前,如果 channelDisabled 为真,也调用一次 InitChannelCache()。
  2. model/subscription_channel_binding.go:273-276(不阻塞,行为变化)到期后不再清标记,标记会留在已结束的订阅上。之后有两处行为变了,而且都更保守:(a) 管理员在订阅过期后手动重新启用了仍在专属组里的渠道,再删除或解绑这条过期订阅时,释放路径会把渠道改回手动禁用(R1 版本会保持启用、移回原分组);(b) 这种情况下再绑定续订,也会沿用标记 2。两处都是失败即关闭,和“永不进入公共池”的目标一致。不过 PR 描述里应该写明,供主管知悉。
  3. 范围:只改了上面列出的 3 个文件,没有碰 R1 chore: merge upstream main (72f3dc7da) into fork-main #2 和 fix(subscription): charge Epay subscriptions at the price per USD (HQ-Task T261105-08) #4 涉及的代码,没有顺手重构。

我没有在本地运行测试,三库的结果取自实施者贴出的实测记录。

@AdoreJc
AdoreJc merged commit 83fdd4e into fork-main Nov 14, 2026
@AdoreJc
AdoreJc deleted the hq/T261113-10-bind-enable-disabled-channel branch November 14, 2026 10:59
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant