Skip to content

[Bug/方案] CodeArts 受控续期存在 RT 丢失窗口:上游已轮换、本地结算失败会让账号永久失效 #655

Open

Description

@Smirk1921

版本与范围

  • 版本:v3.5.0-beta.3 / v3.5.0-beta.4(服务端受控续期路径:core/plugin_host/wasm/codearts_refresh + core/account_store/credential_version/codearts_slot)
  • 影响:CodeArts 账号续期;其它 provider 无关
  • 结论:换票结果只存在内存里。上游已经轮换 RT 之后,本地任何结算失败都会丢新 RT;旧 RT 已作废,账号只能重新登录。

实际观察到的现象

维护日志里出现(账号 id 已截断):

[Accounts] ❌ CodeArts 令牌请求被拒(HTTP 429):{"error_msg":"The throttling threshold has been reached: policy ip over ratelimit,limit:20,time:1 second", ...}
[Accounts] ❌ 账号 codearts-account-… 凭证自动刷新失败: CodeArts 上次续期或登记来源未确认,请先查看原操作状态;不会再次换证、重新占槽或沿用旧值冒充成功
[Accounts] 本轮失败分布:codearts_refresh_unconfirmed×4

一批 66 个账号里,4 个账号进入「上次续期未确认」,之后不再自动换证,只能人工处理。更严重的情况是账号直接失效:上游已接受换票,但本地没存住新 RT。

失败链路(按代码路径逐条)

  1. 上游已换票、本地结算失败 → 丢 RT
    Ready→Pending 占槽 → 发 HTTP → 上游返回新 AT/RT(旧 RT 作废)→ complete_pending_once 写账号与槽。第 4 步任何失败(SQLite busy、COMMIT 未确认、进程退出、写库失败)都会让第 3 步的结果只剩内存:

    • 重试不能用旧 RT(已作废);
    • 槽留在 Pending → 后续永远判「上次续期未确认」;
    • 没有任何落盘记录能证明「上游已经换过」,恢复流程无从补结算。
  2. 收尾失败把槽悬挂在 Pending
    保存/收尾任一步失败后不落 Blocked,账号永久报「上次续期未确认」。

  3. 发送前失败被当成刷新失败
    收据提交锁竞争、HTTP client 构造失败发生在任何字节发出之前,RT 实际未被消费,却把槽封成 Blocked,需要人工停服务重置。

  4. 导入/替换无条件重置 _hostCredentialVersion
    一次整份导入就让所有已登记账号的续期槽版本错位,刷新全部 409;自动维护还会误报「无需刷新」。

  5. 并发换票触发上游 IP 限流
    启动或批量维护并发换票,命中上游约 20 次/秒的 IP 限流(429),批量失败并把槽封 Blocked。

  6. 恢复流程自锁
    恢复在 IMMEDIATE 事务内写运行日志,而日志写同一个库 → 抢自己已持有的写锁;启动期卡在恢复步骤,Windows SCM 30 秒超时后服务起不来。

方案(已在 fork 的 beta.3/beta.4 构建上验证)

1. 换票结果耐久日志(核心)

新表 codearts_refresh_results(CREATE TABLE IF NOT EXISTS,不改 user_version):

account_id PK, operation, generation, db_epoch, born, revision, payload(enc1:), created_at

顺序改成:收到上游响应 → 先加密落盘 → 再结算。

  • 落盘成功后的任何失败,都能在恢复流程里用同一份响应补完;
  • 落盘失败才退回「失败即 Blocked」的旧纪律;
  • 结算成功删除该行。

恢复入口:启动时 + 每轮凭据维护开始时。只有同时满足以下条件才补结算:

  • 账号当前版本 == 日志里的 born + revision;
  • 槽处于 Pending,且 operation、generation、revision、born、db_epoch 全部一致。

任一不一致 → 判陈旧并删除(绝不跨账号/跨代次套用);读/写失败 → 保留记录等下一轮(不丢唯一副本);补结算失败 → 槽落 Blocked 并删除记录(避免无限循环)。

2. 五条不变量

  1. 上游结果未知时,绝不重发同一 RT(at-most-once);
  2. 日志落盘成功后,已轮换的 RT 不丢(durability);
  3. 只有「确认未发出」的阶段才允许自动重试;
  4. 应用日志前必须账号 + 槽身份完全一致;
  5. 恢复必须幂等,可每轮安全执行。

3. 发送前失败与阶段码

  • 收据提交失败重试 4 次(20/40/80/160ms),仍失败回退 Ready;
  • HTTP client 构造失败同样回退 Ready;
  • 两者都不推进账号版本、不消费 RT;
  • 发送之后(可能已发出)的失败才 Blocked,且不自动重试,避免同一 RT 被发两次;
  • 阶段码不再统一成 codearts_refresh_unconfirmed,细分:
    not_ready / pre_send / egress / request / material / read / call / random / send_failed / post_response / complete_failed / journal / unavailable;
  • 维护只对 pre-send 阶段瞬时失败重试(1s、2s,最多 3 次),send_failed 不重试;每 8 个临期账号暂停 2 秒。

4. 导入与限流

  • 导入逐行比较授权材料:未变化沿用原版本;确实变化才重置版本并作废该账号的续期槽;
  • 进程级换票节拍 ≥120ms(约 8 次/秒),降低命中上游 20 次/秒 IP 限流的概率。

5. 恢复日志自锁

事务内只收集文案,事务提交、锁释放后再写运行日志。

验证

  • 单测:加密落盘、同账号覆盖、按操作删除、篡改识别;导入未变更保留、变更重置、普通更新推进。
  • 线上:66 账号 / 66 槽;部署前后槽密文逐字节一致;维护轮次 0 刷新 0 失败;无 codearts_refresh_unconfirmed。
  • 负向:收到响应后 kill -9 → 重启补结算;收尾失败 → 恢复;收据锁竞争 → 回退 Ready。

与当前 beta 的关系(请维护者定方向)

上游 beta 的 e4d8e3f7 已「将 CodeArts 续期迁回插件」,删除了服务端 codearts_refresh、credential_version/codearts_slot*、codearts_enrollment*,新增宿主 db/codearts_slot(FULL 事务 + COMMIT 事实)与插件侧实现。

因此本 fork 的补丁按原文件无法直接合入;但上面的失败窗口与不变量在新架构里仍然成立:

  • db/codearts_slot 解决的是「事务提交事实」,不是「换票结果耐久」;
  • 建议二选一:
    • A(推荐):宿主在 db/codearts_slot 旁开放受限的 journal_result(account, operation, generation, version, payload) + recover() 接口,密钥与事务都留在宿主,插件只调用;
    • B:在插件仓库 ProvidersPlugin/Agent2Providers 内实现同样的 journal/restore,插件自己持有换票响应。

我们可以基于最新 beta 重新实现并提 PR(请指定目标仓库与接口边界),也可以只提供设计、测试用例与复现脚本。

参考

🤖 本条回复由 AI Agent 生成

Activity

  1. coderabbitai commented on Nov 21, 2026

    @coderabbitai
    ⚠️ Possible Duplicate Issue(s)

    🔗 Related PRs

    #631 - fix: 放宽 CodeArts 换证读响应预算,避免弱网下误判未确认 [open]


    📝 Issue Planner

    Check the box below or use the @coderabbitai plan command to generate an implementation plan and prompts that you can use with your favorite coding assistant.

    • Create Plan

    🧪 Issue enrichment is currently in open beta.

    You can configure auto-planning by selecting labels in the issue_enrichment configuration.

    To disable automatic issue enrichment, add the following to your .coderabbit.yaml:

    issue_enrichment:
      auto_enrich:
        enabled: false

    💬 Have feedback or questions? Drop into our discord!

  2. Smirk1921 commented on Nov 21, 2026

    @Smirk1921
    Author

    按这个设计在新架构上落了实现:WASM 插件侧的两阶段暂存(复用现有 account.update,不需要新宿主能力)——ProvidersPlugin/Agent2Providers#57。服务端旧路径的补丁仍保留在分支里,供 3.5 之前的版本参考。

    🤖 本条回复由 AI Agent 生成

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions