「工具调用报 404,重连不是会自动进行吗?再试一次应该就好了。」 这句话里其实有两个假设:重连会处理这种情况,重试也足够安全。社区报告显示,这两个假设都不成立。
原始讨论见 #10783。一位用户使用官方 @deepseek-ai/dsh-mcp-client 连接有状态的 Streamable HTTP 服务,并启用了重连。服务端使会话失效后,工具调用返回 HTTP 404 的 SdkHttpError;稍后再次显式调用时,请求仍携带旧的 Mcp-Session-Id,结果再次返回 404。报告使用的 @modelcontextprotocol/client 版本为 2.2.0。用户也在不加载原环境中安装的第三方管理插件时,直接加载官方客户端复现了这一现象。
排查时常见的六类误判:
- 把工具仍显示在列表里等同于调用能够成功;
- 把所有 404都归因于会话过期;
- 把已启用重连等同于这类故障会自动得到处理;
- 把调用失败等同于上游没有产生副作用;
- 把重载后恢复等同于根本问题已经修复;
- 把一次显式测试调用说成自动重试。
先记住这一点:状态码只是线索,关键证据是「有没有重新初始化」。 站内基础版可参阅 MCP HTTP 会话失效后返回 404 怎么查。
一、报告里实际观察到了什么
先明确一点:第一次失败的调用没有被自动重放。 复现中的两次失败,是分别主动发起的显式调用。
对于会修改数据的工具,这一区别尤其重要:错误响应本身不能证明上游没有产生副作用。 未经检查就再次调用,可能会把同一件事执行两遍。
| 观察结果 | 需要调查的解释 | 单独不能证明 |
|---|---|---|
| 最初发现工具可用 | 当时连接和工具列表存在 | 后续会话仍然有效 |
| 工具调用返回 404 | 服务端返回了 HTTP 错误 | 会话过期是唯一原因 |
| 后续仍使用旧会话 ID | 恢复流程可能没有替换传输 | 第一次调用没有产生副作用 |
| 工具仍显示在列表里 | 注册项仍然存在 | 工具调用能够成功 |
| 重载后恢复 | 新连接改变了现象 | 根本问题已永久修复 |
阅读这张表时,重点看第三列。每一行都可能对应至少两种解释,所以任何一条观察都不足以单独定论。
二、HTTP MCP 和本地子进程有何不同
记忆 MCP 指南说明,DSH 既可以启动配置好的 stdio 命令,也可以连接 Streamable HTTP URL;发现工具后,会以 mcp__<serverName>__<tool> 的形式提供这些工具。
两种传输的运维责任差异很大:
- stdio 子进程由插件生命周期负责启动和停止;
- HTTP 上游服务必须已在运行,DSH 不负责监管独立的 HTTP 服务。
指南针对崩溃的 MCP 子进程描述了带退避的自动重连和工具重新同步,也指出初始发现是异步的。要注意这段说明的适用范围:它讲的是子进程崩溃,不能直接套用于每一种 HTTP 错误。
为什么重连没有触发
讨论中的采纳回答解释了报告所述环境里的机制:监管器会响应传输 generation 结束。HTTP 404 虽然是错误响应,传输却仍处于打开状态。因此,依赖关闭事件的恢复流程没有启动,后续请求仍使用旧会话。
这个解释很有参考价值,但它只解释该报告,不代表所有 404 都由此产生。将它推广成通用结论就超出了证据范围。
三、怎样区分其他 404
按以下顺序排查,每一步尽量只改变一个变量。
第一步,确认版本信息。 核实服务、传输、DSH 客户端和已安装 SDK 的版本。确认服务确实使用有状态 Streamable HTTP,并通过服务端日志核实会话已经过期或失效。分享信息时,不要公开凭据和会话标识。
第二步,梳理时间线。 记录初始化和工具发现是否曾经成功、故障从何时开始;同时检查服务端是否重启、使会话过期,或此前是否返回过其他错误。
第三步,对照请求和服务端证据。 错误端点、代理路由或其他服务端情况也可能返回 404,因此仅凭状态码无法判断原因。
第四步,进行一次低影响测试调用。 条件允许时,在配置的退避时间之后另行发起一次测试,观察是否出现新的初始化和工具发现。使用脱敏后的跟踪信息,并且不要把这次独立调用称为自动重试。
第五步,按部署所支持的流程重载。 如果证据与报告中的情况相符,重载 MCP 插件或重启 DSH Web 可能暂时恢复连接(这是报告者的观察)。恢复后,先确认工具发现已完成,再用一次无害调用验证。
报告中的复现序列
模拟序列为:初始化 → initialized 通知 → 成功的 tools/list → 两次携带旧会话的显式 tools/call → 404。
模拟端点对独立 GET 返回 405,这只是本次复现的细节,不是此类故障的通用前提。关键证据是没有重新初始化,且请求继续使用旧会话,而不是那个孤立的状态码。
四、为什么不该随手重试失败的操作
先确认服务端实际执行了什么。
报告中期望的恢复行为是:向当前调用返回错误,同时为之后的显式调用建立新会话。失败调用不自动重放,是因为工具可能产生副作用。
讨论还提出了更完整的设计建议:丢弃旧传输、初始化新会话、重新同步注册,并将并发失败合并为一次恢复尝试。这些都属于建议行为,不代表已安装版本已经支持。
重载之后先检查什么
重载后,先确认原操作是否已经生效,可以查看操作结果或外部系统。
- 操作已经生效 → 再次执行会造成重复工作;
- 结果仍不确定 → 如果服务提供相应机制,可使用其核对或幂等功能,并与操作负责人共同决定下一步。
只读诊断也应选择不会暴露敏感内容的查询,并确认查询指向预期的服务。
工具消失和工具仍在是两种情况
采纳回答还指出:重连预算耗尽可能导致工具被注销;而报告中的现象是工具仍然存在,但调用失败。
这两类现象都值得排查,但对应的是不同故障。指南提到,崩溃子进程的重连预算耗尽后会停止重试并移除工具,但这不足以推断 HTTP 场景的全部细节。
五、收集证据时的几个分辨点
连接恢复 ≠ 服务健康。 重新发现工具只能说明客户端重新获取了列表;服务端的数据存储、权限和业务状态仍由上游负责。一次调用成功可以证明该次请求得到了响应,不能证明服务端不会再次使会话失效。
界面显示的名称不能反映客户端内部状态。 如果工具名仍在,检查请求是否还指向同一服务器和同一失效会话;如果工具名消失,检查是否发生了连接结束以及重连预算耗尽。
报告中的重连参数只用于描述复现。 enabled: true、initialDelayMs: 500、maxDelayMs: 30000、maxAttempts: 10 这些数值不是推荐修复方案,也不是通用默认值。关键观察是:等待该退避时间后,仍未出现新的初始化。因此,在弄清哪个事件会触发恢复之前,单纯调整延迟数值无法验证这一机制。
服务端重启和客户端重载处理的是不同部分。 HTTP 服务必须已经运行;客户端连接则持有当前传输和已发现的工具注册。报告者观察到,客户端重载可以建立新连接,但这不能证明服务端的过期策略或数据状态发生了变化。记录清楚重启的是哪一侧,以及之后的工具发现是否完成。
怎样交接给别人
可以在不泄露真实会话标识的前提下,按顺序描述情况:初始化成功 → 服务端确认失效 → 调用失败 → 是否出现新的初始化 → 另一次测试调用的结果。附上客户端和 SDK 版本,并删除请求头与业务载荷中的敏感内容。
六、限制与安全边界
工具已注册、重连已启用、重载成功,都不能证明服务可信,也不能保证后续调用成功。 HTTP 端点、认证、持久化和服务生命周期由上游服务与部署负责。采用报告中的处理办法前,应先确认版本和配置——后续版本的行为可能不同。
URL、请求头、会话标识、载荷和工具结果都可能包含敏感信息,分享诊断内容前应先脱敏。不要为了测试重连而反复执行有副作用的操作;重启也可能中断他人工作,应遵循本地运行流程。
受控复现应使用效果明确的测试服务和工具:先确认发现成功,再用服务支持的方式让测试会话失效,随后记录下一次调用和连接活动。不要仅为复现社区报告而使生产会话失效。
最后还要注意:不要把重载后的测试结果和原调用结果混为一谈。 测试可以说明新连接能够响应,不能反证原操作是否已经生效。对于写入、发送、创建等工具,应检查相应业务记录;必要时请负责系统的人核对,再决定是否发起新的显式调用。
七、术语速查
- Streamable HTTP:报告中的 MCP 连接所使用的 HTTP 传输。
- MCP 会话 ID:将请求与服务端有状态会话关联起来的标识。
- 传输 generation:客户端当前连接与传输的生命周期。
- 工具发现:获取服务端工具并注册以供调用的过程。
- 显式重试:主动发起的新调用,用来区别于自动重放失败请求。
相关阅读
- MCP HTTP 会话失效后返回 404 怎么查
- stdio 与 Streamable HTTP 两条 MCP 路径
- MCP 工具命名规则
- 给 stdio MCP 服务传必需的环境变量
- 用 OAuth 连接内网 MCP
- 更多 DSH 实践文章
本文依据 DeepSeek Harness 记忆 MCP 指南与社区讨论 #10783 整理,由 DSH Plugin 社区(dsh-plugin.com)维护者撰写,首发于阿里云开发者社区。
原文地址:https://dsh-plugin.com/zh/blog/mcp-http-session-expired-404
插件与文档收录于:https://dsh-plugin.com/zh/blog