读取线路中的错误
调用失败时，解读错误代码和错误消息。
读取线路中的错误 是 CoddyKit 上的免费 MCP Academy 课时。 这是第 4 节课，共 4 节。 你可以在下方免费阅读本课时的完整内容 — 然后在浏览器中使用内置代码编辑器和全天候 AI 导师进行实践。 这是 MCP Academy 学习路径的一部分，你的进度在网页和 CoddyKit 应用中同步。 MCP Academy 课程共包含 4 节课。
调用出错时
并非每个请求都会成功。发生失败时，JSON-RPC 会返回一个 错误对象，而不是结果；读取它是最快的修复途径。
错误对象
错误响应会保留请求的 id，但会用包含代码和消息的错误对象替换结果。
{"jsonrpc": "2.0", "id": 3,
"error": {"code": -32601, "message": "Method not found"}}代码是数字
每个错误都会携带一个数字代码。标准 JSON-RPC 代码都是负数，其中有几个会在通信中反复出现。
解析错误：-32700
代码 -32700 表示服务器甚至无法解析您的 JSON。通常是多余的逗号或不匹配的引号破坏了消息本身。
{"error": {"code": -32700, "message": "Parse error"}}找不到方法：-32601
代码 -32601 表示该方法名称不存在。请检查是否有拼写错误，或者是否调用了服务器从未公布的方法，例如 toolz/list。
{"error": {"code": -32601, "message": "Method not found"}}参数无效：-32602
代码 -32602 表示参数有误：可能缺少参数，或参数类型不正确。方法确实存在，但您发送的输入不符合要求。
{"error": {"code": -32602, "message": "Invalid params"}}内部错误：-32603
代码 -32603 是服务器用于统括内部问题的错误代码。请求本身没有问题，但服务器在处理请求时发生了故障。
{"error": {"code": -32603, "message": "Internal error"}}读取消息字段
代码告诉您错误的类别；消息则告诉您具体情况。请务必阅读它，因为服务器通常会补充指出失败的确切字段或原因。
用于详细信息的可选数据
错误还可能包含一个 数据字段，其中提供额外的结构化详细信息，例如被拒绝的是哪个参数。如果存在该字段，它对调试非常有帮助。
{"error": {"code": -32602, "data": {"field": "a"}}}协议错误与工具失败
JSON-RPC 错误表示协议本身出现了问题。一个正常运行但返回 isError 的工具仍然会产生普通结果，因此请不要混淆这两种情况。
调试反射
养成这样的习惯：先阅读代码来判断类别，再阅读消息来定位问题，最后检查数据以找出确切原因。大多数 MCP 错误都可以用这种方式迅速定位。
快速检查
您发送了一个有效的方法，但缺少一个参数。哪一个错误代码符合这种情况？
回顾：解码失败
现在您已经能够熟练读取失败信息：错误对象包含代码、消息，有时还包含数据。代码用于分类，消息用于解释，数据用于精确定位原因。
用 AI 导师学习 Python — 免费
在浏览器中编写并运行真实代码，获得全天候 AI 导师的即时帮助，并在网页或应用中继续学习。
- 课程
- 30
- 课程
- 120
常见问题解答
「读取线路中的错误」课时是免费的吗？
是的 — 「读取线路中的错误」的完整文本可在网页上免费阅读。要进行交互式练习（内置代码编辑器和全天候 AI 导师）并解锁 MCP Academy 课程的其余内容，请升级到 CoddyKit PRO。 MCP Academy 课程共包含 4 节课。
「读取线路中的错误」这节课中我会学到什么？
调用失败时，解读错误代码和错误消息。 你通过在浏览器中直接运行的动手代码来练习 MCP Academy，全天候 AI 导师会在你学习这节课的过程中回答你的问题。
学习 MCP Academy 需要有经验吗？
无需任何先前经验。CoddyKit 上的 MCP Academy 课程适合初学者到高级学习者，你可以从这里开始或从头开始，按照自己的节奏学习。 这是第 4 节课，共 4 节。
「读取线路中的错误」课时需要多长时间？
大多数 CoddyKit 课程大约需要 5–10 分钟。每节课都很精短且互动，所以你能稳步进步，并在网页和应用中从离开的地方继续。
我能在这节 MCP Academy 课中编写并运行代码吗？
能。每节 MCP Academy 课都包含内置代码编辑器，你可以在浏览器中直接编写并运行真实代码，并获得即时 AI 反馈 — 无需本地设置。
此课程中的所有课时
- 请求、响应与通知
- JSON-RPC 调用的结构
- 初始化握手
- 读取线路中的错误