不能直接用 http.ServeMux 做 JSON-RPC 方法路由,因为其仅按 URL 路径分发,而 JSON-RPC 请求均打到同一 endpoint(如 /rpc),真实路由依据是请求体中 method 字段;需用 map[string]func(*jsonrpc2.Request) (interface{}, error) 动态注册方法,并统一处理空方法名、未注册方法和 panic 等边界情况。

为什么不能直接用 http.ServeMux 做 JSON-RPC 方法路由
JSON-RPC 请求体里不带路径信息,http.ServeMux 只能按 URL 路径分发,而所有 JSON-RPC 请求通常都打到同一个 endpoint(比如 /rpc),真正的路由依据是请求 JSON 中的 method 字段。硬套 ServeMux 会导致所有方法挤在同一个 handler 里做字符串 switch,难以测试、无法反射注册、也不支持中间件链。
用 map[string]func(*jsonrpc2.Request) (interface{}, error) 实现动态方法注册
最轻量又可控的方式,是维护一个方法名到处理函数的映射表。关键点在于:处理函数签名必须统一,且要能拿到原始 *jsonrpc2.Request(或你封装的结构体),以便提取 params、检查 id、返回标准响应。
-
method名作为 map key,区分大小写,建议全小写+下划线(如"user_create") - 注册时检查重复:若
map已存在同名 key,panic 或 log warn,避免静默覆盖 - 函数体内不做
json.Marshal响应——留给统一的 RPC server 封装,只返回业务数据和 error - 示例:
handlers["user_get"] = func(req *jsonrpc2.Request) (interface{}, error) { var id int if err := json.Unmarshal(req.Params, &id); err != nil { return nil, &jsonrpc2.Error{Code: -32602, Message: "invalid params"} } u, err := db.GetUserByID(id) return u, err }
如何安全地从 req.Method 查找并调用对应 handler
查 map 本身很快,但要注意三个边界:
- 空方法名:
req.Method == ""→ 直接返回InvalidRequest错误(code -32600) - 未注册方法:
handler, ok := handlers[req.Method]→!ok时返回MethodNotFound(code -32601) - handler panic:必须 recover,转为
InternalError(code -32603),否则整个 HTTP 连接会断开 - 不要在 handler 内修改
req字段(尤其是Params),多个并发请求可能共享同一内存
支持带前缀的 method 名(如 auth.login)需要额外解析逻辑
如果协议约定 method 支持点号分隔的命名空间(如 "auth.login"、"file.upload"),就不能直接当 map key 查了。得先按点切分,再逐级查找子 map 或用 strings.Split(req.Method, ".") 拼合成键(如 "auth_login")。
立即学习“go语言免费学习笔记(深入)”;
- 推荐统一转换规则:替换
.为_,避免嵌套 map 带来的复杂度和反射开销 - 若需保留层级语义(比如权限校验按前缀分组),可在注册时拆解
req.Method,把"auth"提出来传给中间件,而不是让 handler 自己解析 - 注意:Go 的
strings.Split对空字符串返回[]string{""},req.Method == "."这种非法值要提前过滤
*jsonrpc2.Error 如果 code 值随意写,前端很难做统一提示。建议把常用错误码定义成常量,比如 ErrInvalidParams = &jsonrpc2.Error{Code: -32602, Message: "invalid params"},然后复用。



















