mcp: 兼容 session 过期,自动重新握手

某些 MCP 服务在长时间空闲后会主动让旧 session 失效,下次非 initialize
请求会返回 400 并提示 missing/invalid Mcp-Session-Id。之前 mcp.js 一直
复用启动时缓存的 server.sessionId,会持续报错。

本次在 rpc() 出口处加一个最小补偿:仅当 method 不是 initialize、状态码
是 400、错误体含 'session' 时,清掉旧 id、重新跑 initialize +
notifications/initialized、再重试一次原请求。initialize 调用走当前函数
的 method !== 'initialize' 分支天然不会带旧 header,递归链路自动终止
在 initialize 那一层(不会无限循环)。

工具表(toolDefs / toolIndex)保持 init() 时的快照不变——session 重连
只换 id,不动工具表,避免工具集差异导致调用方混淆。重连失败或重连后
仍然 400 时原样向上抛错,由调用方决定如何应对。
This commit is contained in:
2026-09-04 20:50:59 +08:00
parent cb780cfb0b
commit 8ac62bedd9
+26 -1
View File
@@ -15,6 +15,7 @@ let builtinNames = new Set();
// 发一次 JSON-RPC 请求,返回 { result, headers }(HTTP 非 2xx / error / 无法解析时抛异常)。 // 发一次 JSON-RPC 请求,返回 { result, headers }(HTTP 非 2xx / error / 无法解析时抛异常)。
// 某些 MCP 服务遵循 Streamable HTTP 规范会在 initialize 响应里返回 Mcp-Session-Id, // 某些 MCP 服务遵循 Streamable HTTP 规范会在 initialize 响应里返回 Mcp-Session-Id,
// 之后所有非 initialize 请求都必须带上该 header,否则返回 400。我们把会话 id 缓存在 server.sessionId 里。 // 之后所有非 initialize 请求都必须带上该 header,否则返回 400。我们把会话 id 缓存在 server.sessionId 里。
// session 过期补偿:非 initialize 请求若 400 且错误信息含 session,清掉旧 id 并重新 initialize 后重试一次。
async function rpc(server, method, params, timeoutMs) { async function rpc(server, method, params, timeoutMs) {
const callId = Date.now(); const callId = Date.now();
const ctrl = new AbortController(); const ctrl = new AbortController();
@@ -36,7 +37,31 @@ async function rpc(server, method, params, timeoutMs) {
// 响应头里出现 Mcp-Session-Id 就缓存到 server(多处出现都被覆盖为最后一次,重复请求同一服务后保持一致) // 响应头里出现 Mcp-Session-Id 就缓存到 server(多处出现都被覆盖为最后一次,重复请求同一服务后保持一致)
const sid = res.headers.get('mcp-session-id'); const sid = res.headers.get('mcp-session-id');
if (sid) server.sessionId = sid; if (sid) server.sessionId = sid;
if (!res.ok) throw new Error('HTTP ' + res.status + ': ' + raw.slice(0, 300)); if (!res.ok) {
// session 过期补偿:仅对非 initialize 请求,400 且错误信息含 session 时重新握手后重试一次。
// 不调 tools/list —— 工具表在 init() 时已经发现并固化,运行期间不需要重新发现。
if (method !== 'initialize' && res.status === 400 && /session/i.test(raw)) {
clearTimeout(timer);
log.warn('[mcp] ' + server.name + ' session 疑似过期,重新握手: ' + raw.slice(0, 200));
server.sessionId = null;
// 重新跑 initialize,递归走当前函数,method=initialize 不会再触发重连逻辑
try {
await rpc(server, 'initialize', {
protocolVersion: '2024-11-05',
capabilities: {},
clientInfo: { name: 'agent', version: '1.0.0' },
}, 15000);
// 按 MCP 规范发 notifications/initialized(无响应体,失败不阻断)
try { await rpc(server, 'notifications/initialized', {}, 5000); } catch (_) { /* 通知失败不阻断 */ }
} catch (e) {
// 老服务可能没有 initialize,会报 Method not found;不阻断,按既有兼容走原通道
if (!/Method not found/i.test(String(e && e.message || e))) throw e;
}
// 重试原请求(新一次 fetch + 新 AbortController)
return await rpc(server, method, params, timeoutMs);
}
throw new Error('HTTP ' + res.status + ': ' + raw.slice(0, 300));
}
// 响应可能是 SSE 帧(多行 data: {...}),取 id 匹配或最后一条 JSON // 响应可能是 SSE 帧(多行 data: {...}),取 id 匹配或最后一条 JSON
let payload = null; let payload = null;
try { try {