工具仍在列表里,调用却返回 404?厘清会话失效、传输未换与自动重放

简介: MCP 工具调用返回 HTTP 404 时,最容易想到的是「会话过期了,重连一下就好」。但社区报告揭示的机制恰好相反:**重连配置虽已启用,404 却没有触发恢复**,因为恢复依赖「传输关闭」事件,而 404 只是错误响应,传输仍保持打开。更关键的是,**失败的调用没有被自动重放**——对于有副作用的工具,这决定了是否可能重复执行。

「工具调用报 404,重连不是会自动进行吗?再试一次应该就好了。」 这句话里其实有两个假设:重连会处理这种情况,重试也足够安全。社区报告显示,这两个假设都不成立。

原始讨论见 #10783。一位用户使用官方 @deepseek-ai/dsh-mcp-client 连接有状态的 Streamable HTTP 服务,并启用了重连。服务端使会话失效后,工具调用返回 HTTP 404 的 SdkHttpError;稍后再次显式调用时,请求仍携带旧的 Mcp-Session-Id,结果再次返回 404。报告使用的 @modelcontextprotocol/client 版本为 2.2.0。用户也在不加载原环境中安装的第三方管理插件时,直接加载官方客户端复现了这一现象。

排查时常见的六类误判:

  1. 把工具仍显示在列表里等同于调用能够成功;
  2. 把所有 404都归因于会话过期;
  3. 把已启用重连等同于这类故障会自动得到处理;
  4. 把调用失败等同于上游没有产生副作用;
  5. 把重载后恢复等同于根本问题已经修复;
  6. 把一次显式测试调用说成自动重试。

先记住这一点:状态码只是线索,关键证据是「有没有重新初始化」。 站内基础版可参阅 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:客户端当前连接与传输的生命周期。
  • 工具发现:获取服务端工具并注册以供调用的过程。
  • 显式重试:主动发起的新调用,用来区别于自动重放失败请求。

相关阅读

本文依据 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

目录
相关文章
|
8天前
|
Linux Go 开发工具
手机上跑 DeepSeek 智能体:开源安卓客户端 DSH Go 安装与使用指南
DSH Go 是一款开源安卓客户端,将 DeepSeek Harness 智能体引擎装进手机:免 Root、免 Termux,一键安装即用;支持本机运行(内置 Ubuntu+Node.js)或远程接管电脑会话;具备插话打断、过程折叠、屏幕操控、端到端加密分享等特色功能,真正实现智能体“口袋化”。
9190 24
|
8天前
|
弹性计算 人工智能 API
Codex超详细入门指南(下载·安装·登录·上手,全版本覆盖,2026最新版)
建议收藏本教程,2026 全年各版本更新随时回来查阅。如果你在搭建过程中遇到任何问题,欢迎结合 阿里云工单系统 提交技术支持请求,或在 阿里云开发者社区 搜索 Codex 相关话题交流。 祝你编码愉快,效率翻倍!
2708 14
|
3天前
|
人工智能 安全 应用服务中间件
NGINX 爆出两处高危漏洞 可导致未经身份验证的远程代码执行
NGINX曝出两个高危漏洞(CVE-2026-123633和CVE-2026-123007),CVSS 9.2分,均属HTTP/2内存安全缺陷,无需认证即可远程执行代码。影响自2015年起的多个版本,静态站点亦受威胁。修复版本为开源版1.30.7/1.31.9。(239字)
1299 0
NGINX 爆出两处高危漏洞 可导致未经身份验证的远程代码执行
|
6天前
|
传感器 安全 区块链
Windows 电脑运行安卓应用教程:开源工具 ApkStart 双击 APK 即装、独立窗口运行
ApkStart 是一款开源Windows工具,让安卓APP像原生软件一样运行:双击APK即安装、生成真实图标、独立窗口启动、开始菜单可搜索。无需传统模拟器,内置QEMU运行时,支持数据互通、ARM兼容与命令行操作。(239字)
|
10天前
|
人工智能 前端开发 API
阿里云Qwen4-Max 大模型详解:定位、特征、能力、适用场景与相对Qwen3-Max差异解析
2026年11月11日,阿里发布第四代旗舰模型Qwen4-Max预览版,首发千问AI平台Token Plan并接入千问办公、Qoder等入口。该版本聚焦知识理解、世界感知、编程与Agentic四项升级,主打复杂编程、专业办公、前端设计与专业软件操作等真实任务。预览期为11月11日10:00至11月25日24:00,仅支持Token Plan调用,到期后模型标识下线;限时2折、新用户再享5折,最低1折可体验。
|
10天前
|
JSON 前端开发 API
阿里云最新Qwen4-Max大模型介绍:模型定位、特征、能力、适用场景解析
2026 年 11 月 11 日,阿里发布第四代旗舰模型Qwen4-Max预览版,首发千问 AI 平台 Token Plan,并同步接入千问办公、Qoder 等入口。该版本聚焦知识理解、世界感知、编程与 Agentic 四项升级,主打复杂编程、专业办公、前端设计与专业软件操作。预览期至 11 月 25 日 24:00,到期后模型标识下线;限时 2 折、新用户再享 5 折,最低 1 折可体验。
|
23天前
|
Linux 开发工具 iOS开发
Codex保姆级教程(下载+安装+登录+使用,含所有版本,2026最新)
Codex是OpenAI推出的开源AI编程智能体,本地运行,可理解整个代码库,支持自然语言指令改代码、执行命令、跑测试、修Bug,兼容Win/macOS/Linux。(239字)
11204 59
|
4天前
|
人工智能 弹性计算 IDE
Codex超详细入门指南(下载·安装·登录·上手,全版本覆盖,2026最新版)
适合团队落地代码规范,每次提交自动生成评审报告,降低人工CR工作量。同时支持自定义技能脚本,接入团队内部SDK说明文档,让Codex生成符合团队编码规范的代码。Codex三大客户端覆盖本地开发、服务器远程编码、自动化流水线场景,搭配阿里云百炼的Token Plan、Coding Plan,能够低成本搭建稳定可控的AI编码助手。新手建议先从IDE插件入手,熟悉交互逻辑,再尝试CLI版本部署在阿里云ECS,实现云上项目远程编码、批量脚本处理。只要按照步骤完成环境准备、版本选型、密钥对接、项目初始化,就可以把Codex融入日常开发流程,大幅提升代码编写、问题排查、项目重构的效率。
951 0
|
6天前
|
人工智能 弹性计算 开发工具
零成本玩各大模型!DeepSeek Harness dsh-our-free-model 插件,13 个厂商模型直接用
总结一下:装这个插件,你不用注册、不用绑卡、不用填一个 Key,就能在 DeepSeek Harness 里用上 DeepSeek V4.1 Flash、Kimi K3 这一批前沿模型,而且是白嫖的、还不限量。三步搞定:下载插件,复制包含 `package.json` 的插件目录路径,在「添加插件」里粘贴路径安装并重启。无论是在阿里云 ECS 上通过命令行部署的 Web 版,还是本地的 Electron 桌面端,都能顺利跑通,快速搭建一套零成本的免费模型使用环境。
1339 1
|
9天前
|
Linux API iOS开发
【DSH】DeepSeek Harness新手保姆教程(下载+安装+配置+使用,2026最新实测)
DeepSeek Harness(dsh)是DeepSeek AI开源的智能体框架,秉持“一切皆插件”理念,支持读文件、改代码、跑命令、处理表格、联网搜索等操作。免费开源,兼容Windows/macOS/Linux,提供桌面端与网页端,可灵活安装插件扩展能力。