Skip to content

插件错误被归类为不可重试的 bad_params,整轮直接 400,且文案丢失根因 #613

Closed

Description

@sixsixdog

插件错误被归类为不可重试的 bad_params,整轮直接 400;且文案丢失根因

环境

  • Agent2API 3.5.0-beta.3(Docker,Debian 12,db schema 30)
  • 插件 agent2api-wasm-workbuddy 0.1.0-beta.1
  • 客户端:DSH 桌面(ua=deepseek-harness/0.2.2-rc.5 dsh-profile/desktop),走网关 Key(名字已隐去)

现象

上游一侧的「消息条数超上限」场景,被网关映射为:

HTTP 400
{"error":{"code":"bad_params","message":"WorkBuddy网络请求未完成","type":"invalid_request_error","param":""}}
  • attempt_details[].status = 400、first_response_ms = null、attempts = 1
  • 命中默认规则 bad_request(400) → return_error,不重试、不换账号
  • 日志表里没有可供定位的 error/warn 记录(只有 Wasm 插件计算用量),只能看到「网络请求未完成」这一句

问题

  1. 分类过粗:插件/上游连接中断这类偶发传输错误被当成客户端参数错误(bad_request),直接整轮失败;而默认 transient(408/500/502/503/504) → retry_then_switch 救不到它。
  2. 文案丢失根因:插件返回的具体原因(本次是「消息条数超过上游上限」)在网关面被统一成「网络请求未完成」,用户无法自救。
  3. 缺少可观测性:这类失败没有 error 级日志,面板上只看到 首响 -、耗时几十毫秒。

建议

  1. 允许错误规则按 provider + 插件返回码 精确匹配(现有规则已有 code/provider 字段,但插件侧错误似乎没有落到可匹配的 code 上);或
  2. 把「插件报告网络未完成 / 上游连接被关闭」归入 transient,走 retry_then_switch(换账号/换次重试通常就能过);
  3. 透传插件原始错误信息,至少写一条 error 级日志(含 provider、账号、上游 URL、插件 code);
  4. 入站侧若能在发往 provider 前就知道上限(如 max_outbound_messages),提前返回明确 400:
    消息条数 519 超过 provider 上限 512。

复现

同 ProvidersPlugin/Agent2Providers#48 的最小复现:messages 511 条返回 200,512 条返回上述 400,耗时 68–99 ms(本地纯拒绝 6–10 ms,说明已发往上游后被掐断)。

Activity

  1. coderabbitai commented on Nov 19, 2026

    @coderabbitai
    🔗 Related PRs

    #595 - 修复:上游错误统一按候选失败顺延 [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. sixsixdog commented on Nov 20, 2026

    @sixsixdog
    Author

    补充:根因已定位到插件侧。

    同一上游模型走另一个实现(workbuddy2api-hub)时 512 / 600 条消息都是 200,说明不是上游限制;而 Agent2API 侧 512 条消息的请求,插件计量显示 durationMs=18、hostCalls=16,没有发出上游请求就直接失败了,对外被映射成 bad_params + 文案「WorkBuddy网络请求未完成」。

    所以这条 issue 的核心诉求不变、而且更重要:插件在本地就能判定的错误不应被归类成不可重试的 bad_request,且文案必须透出真实原因(消息数超限),否则客户端只能看到「网络问题」并反复重试。

    细节与对照数据见 ProvidersPlugin/Agent2Providers#48 的最新评论。

  3. sixsixdog commented on Nov 20, 2026

    @sixsixdog
    Author

    补充一条更关键的数据点:内置 provider(CodeArts)同样在 513 条消息处失败。

    请求 结果
    msgs=512 200(2132 ms)
    msgs=513 400(88 ms),文案「CodeArts 上游未完成本次请求,原始敏感诊断已隐藏」
    msgs=547 400(81 ms)
    msgs=2 但 body 1.9 MB 200(6062 ms)

    说明这个上限不是某个插件 provider 私有,而是宿主侧共用的对话预处理/转发层里的 512 条消息上限;不同 provider 只是把它包装成不同错误文案,然后统一落进 bad_request → return_error(不可重试、整轮失败)。

    因此本 issue 的两条诉求更强了:

    1. 上限本身应可配置(或超出时自动合并老消息),而不是硬拒;
    2. 这类本地就能判定的失败必须给出明确原因(too_many_messages + 当前条数/上限),不能伪装成上游网络错误 —— 现在面板上看到的是「上游未完成本次请求」「网络请求未完成」,完全误导排查方向。
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