展开知识库目录
MCP 出现 404、429、超时和断线，怎样检查端点、限流与网络
端点错误、资源不存在、限流、上游慢和网络中断的处理不同。
404、429、超时和断线先看请求时间线
端点错误、资源不存在、限流、上游慢和网络中断的处理不同。保存 URL 结构、时间、状态、响应头、重试和各层日志，不把所有错误当成本地配置。
404
常见原因：Server URL、base path、版本、资源或代理路由不匹配。
处理方法：从健康或能力端点开始核对最终 URL，检查代理实际转发路径和资源存在性。
记录 Client、Server、配置位置、传输方式、认证范围、工具列表和一次真实调用结果。
只有实际现象和证据与这一分支吻合时才执行处理；不吻合就继续检查下一层。
429
常见原因：客户端、Server、上游或账号在某个时间窗限流。
处理方法：读取响应头和官方限制，降低并发并按退避重试；写操作先确认幂等。
确认“429”已经有可回查结果，再进入“超时”；依据仍然来自猜测时，把缺口单列并停在当前步骤。
只有实际现象和证据与这一分支吻合时才执行处理；不吻合就继续检查下一层。
超时
常见原因：连接、Server 处理、外部依赖或客户端总时限先触发。
处理方法：记录各阶段耗时和超时配置，缩小请求，避免只把时限调大。
确认“超时”已经有可回查结果，再进入“断线”；依据仍然来自猜测时，把缺口单列并停在当前步骤。
只有实际现象和证据与这一分支吻合时才执行处理；不吻合就继续检查下一层。
断线
常见原因：进程退出、休眠、代理空闲、网络切换或服务重启。
处理方法：关联重连与 Server 生命周期，确认是否能安全恢复未完成调用。
先用只读、小范围请求验证连接；涉及写入、删除、付款或外发时必须重新确认对象与权限。 完成后把证据归入“请求时间线与重试决定”。
只有实际现象和证据与这一分支吻合时才执行处理；不吻合就继续检查下一层。
重试决定必须写副作用和上限
只读请求与幂等写请求可以在条件允许时重试；未知是否已成功的创建、发送或付款不能自动重放。