Skip to content

[upstream-idea] 将配置的 TLS 握手超时视为瞬时传输错误并重试(CLIProxyAPI) #913

Closed as not planned

Description

@LIghtJUNction

来源(只读观察,未在对方仓库留言)

  • 仓库:router-for-me/CLIProxyAPI
  • 提交:345cc9d5a895 — feat(claude): add timeout and retry logic for silent TLS handshakes(Closes 上游 #6615)
  • 配置整理:b3dc6c3fe52b — 将 tls-handshake-timeout-seconds 挪到根级 request 配置
  • 相对上次观察 tip:0d18d3b365be → 5fc580b1d72d(本轮 12 个;其余见下「不适用」)

做什么 / 为什么值得评估

上游给共享 uTLS 客户端加了可选的 TLS 握手时限,并把超时从「调用方 context.DeadlineExceeded」里拆出来:

  1. 仅在父请求 context 仍存活、子握手 deadline 先到时,包装为专用 ConfiguredTLSHandshakeTimeoutError
  2. 该错误计入 transient / pre-HTTP transport,在现有 request-retry 预算内自动重试
  3. 不对凭据/渠道做 cooldown(避免把健康 key 误伤)
  4. 调用方自己的 deadline / cancel 仍保持不可重试

对 LMM 多渠道网关,「对端 TLS 握手卡住、连接半开」并不少见;若与 caller deadline 混在一起,要么不重试,要么误惩罚渠道。这与已开的 #907(HTTP/2 closed 当瞬时)同属传输生命周期分类,可一并评估。

建议评估点

  1. apps/api-go(及 WIP core)HTTP 客户端是否已设 TLSHandshakeTimeout;超时错误链是否可与 caller deadline 区分
  2. 渠道失败分类是否把「握手超时 / 连接建立失败」当瞬时并重试,且不触发 disable/cooldown
  3. 流式已写出 token 后不得无条件重试;须尊重钱包预扣与幂等边界
  4. 测试:handshake timeout vs caller cancel vs 真正的证书/协议错误

路径候选

方向 LMM 可能位置
HTTP 客户端 / TLS apps/api-go channel HTTP helpers;WIP 对应 core transport
错误分类 / 重试 relay retry / channel status(与 #907 同一层)

工作量 / 优先级

小~中;可靠性。可与 #907 同 PR 评审。后端即可,不需要 Opus。

同批不适用(N/A)

SHA 原因
5fc580b1d72d watcher 文件删除追踪 / auth snapshot CLIProxyAPI 本地 auth 文件监视专用
08e5762a9a3c model registration fencing / epoch publish 其 registry 并发模型专用
5efe97582c05 Antigravity Claude tool anyOf 展平 Antigravity translator 专用
50eaed0d1686 pluginapi config field defaults 插件管理 API
8fb633c9fa / 912a038b8b Antigravity client / cache tokens Antigravity 专用
7f2f17d76f Gemini MALFORMED_FUNCTION_CALL 可重试 Claude↔Gemini translator 路径
5825700762 tool use ID 跨 turn 去重 同上 translator
f9ac397be2 / a19a8ecde3 muse / gemini-3.8 registry 模型目录更新

不做的事

不在 CLIProxyAPI 开 issue/评论;不跟进其 Antigravity/translator/registry。相关已有想法:#902(body 上限)、#907(HTTP/2 closed)。

Activity

  1. added
    upstream-ideaIdea derived from other open-source relay/gateway projects
    botOpened by the maintenance bot
    on Oct 14, 2026
  2. LIghtJUNction commented on Nov 14, 2026

    @LIghtJUNction
    MemberAuthor

    本 Issue 已合并到 #990 统一跟踪:#990

    本次关闭仅用于合并去重,不代表问题已修复、已验收或放弃处理。原始正文和讨论仍保留在这里,后续实现与验收请使用新 Issue。

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

    botOpened by the maintenance botupstream-ideaIdea derived from other open-source relay/gateway projects

    Type

    No type

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions