MCP服务优雅关闭的实测陷阱
AI 总结
作者用一个 Express + Streamable HTTP 的 MCP Server 运行八秒 slow_task,测试发版关闭流程。任务运行两秒后服务端收到 SIGTERM,但客户端仍为已经断开的连接等待58秒并报告 MCP 超时;server.close() 虽保留任务,却等待连接关闭而非任务完成。实测有效的流程是摘流量、停止监听、等待 inflight 任务并主动断开剩余连接。
深度见解
实测表明,部署长任务 MCP 工具时不能只依赖 server.close(),还需要健康检查摘流、任务计数、有上限的等待和主动断连。
我模拟了一次发版:一个 8 秒的任务跑到第 2 秒,服务端收到 SIGTERM。
然后我盯着客户端,等它告诉我出事了。
它等了 58 秒,报了一句"请求超时"。
那一刻我意识到,服务端早就没了,客户端却还在等。等到它自己的超时用尽,才给出一个"超时"——而这个错误会让人以为"服务只是慢",于是重试,于是又打到另一个正在被杀的实例。
这篇把发版那一刻的事从头跑了一遍:三种关闭方式,同一个 8 秒的任务,看客户端到底收到什么。
结论先放这儿:server.close() 不是"等我一下",是"等连接关";而客户端分不清"服务死了"和"服务慢了"。