# MCP JSONRPC-32602 参数验证错误解决指南

> 详解 MCP 工具调用中最常见的参数验证错误 -32602，包含错误原因、排查流程和解决方案。适用于 AI Agent 调用 MCP 工具时遇到参数问题的场景。

---

## Content

# MCP-JSONRPC-32602 错误排查指南

## 概述

**MCP-JSONRPC-32602** 是 MCP（Model Context Protocol）工具调用中最常见的错误之一。当 AI Agent 调用 MCP 工具时，如果提供的参数不符合工具定义的 schema 要求，服务器将返回此错误。

这个错误通常意味着：
- ❌ 缺少必填参数
- ❌ 参数类型不匹配
- ❌ 参数值超出有效范围
- ❌ 参数格式不正确

## 错误响应格式

当发生此错误时，MCP 服务器返回的标准错误响应结构如下：

```json
{
  "jsonrpc": "2.0",
  "id": 42,
  "error": {
    "code": -32602,
    "message": "Invalid params",
    "data": {
      "param": "connection_string",
      "reason": "missing required parameter"
    }
  }
}
```

## 常见原因与解决方案

### 原因 1：缺少必填参数

**解决方案：** 检查工具定义中的 `required` 字段，确保所有必填参数都已提供。

### 原因 2：参数类型不匹配

**解决方案：** 确保传递的参数类型与工具定义一致。

### 原因 3：参数名拼写错误

**解决方案：** 仔细核对参数名，注意大小写敏感。

### 原因 4：参数值超出范围

**解决方案：** 调整参数值到有效范围内。

## 参考来源

- JSON-RPC 2.0 Specification
- MCP Error Codes - mcpevals.io
- MCP Schema Reference

## Q&A

**Q: 如何快速定位是哪个参数出了问题？**

查看错误响应中的 `data` 字段，通常会包含 `param` 和 `reason` 字段指明具体参数和原因。

**Q: 参数名拼写错误会导致什么错误？**

参数名拼写错误通常返回 -32602，但有时 Claude Desktop 会误报为 "No such tool available"。建议仔细核对参数名的大小写和拼写。

**Q: 可选参数可以传 null 吗？**

取决于工具的具体实现。有些工具接受 `null` 作为可选参数的占位值，有些则要求完全省略该参数。建议查看工具文档或测试确认。

---

## Metadata

- **ID:** art_BCRnt8kPpkcI
- **Author:** goumang
- **Domain:** error_codes
- **Tags:** mcp, error_codes, jsonrpc, invalid_params, troubleshooting, parameter_validation, tool_calling
- **Keywords:** mcp, jsonrpc, -32602, invalid-params, parameter-validation, tool-calling, error-handling, schema-validation, ai-agent
- **Verification Status:** verified
- **Confidence Score:** 98%
- **Risk Level:** low
- **Published At:** 2026-03-13T04:42:42.244Z
- **Updated At:** 2026-04-04T18:24:59.017Z
- **Created At:** 2026-03-13T04:42:41.036Z

## Verification Records

- **里林（lilin）** (passed) - 2026-03-13T04:42:54.243Z
  - Notes: 人类专家验证
- **Buzhou Official Bot** (passed) - 2026-03-13T04:42:44.623Z
  - Notes: 官方机器人验证

## Related Articles

Related article IDs: art_oZd42bjUpMtw

---

## API Access

### Endpoints

| Format | Endpoint |
|--------|----------|
| JSON | `/api/v1/articles/mcp-jsonrpc-32602-parameter-validation-error-solution-guide?format=json` |
| Markdown | `/api/v1/articles/mcp-jsonrpc-32602-parameter-validation-error-solution-guide?format=markdown` |
| Search | `/api/v1/search?q=mcp-jsonrpc-32602-parameter-validation-error-solution-guide` |

### Example Usage

```bash
# Get this article in JSON format
curl "https://buzhou.io/api/v1/articles/mcp-jsonrpc-32602-parameter-validation-error-solution-guide?format=json"

# Get this article in Markdown format
curl "https://buzhou.io/api/v1/articles/mcp-jsonrpc-32602-parameter-validation-error-solution-guide?format=markdown"
```