Golang实现RPC调用教程详解

积累知识，胜过积蓄金银！毕竟在Golang开发的过程中，会遇到各种各样的问题，往往都是一些细节知识点还没有掌握好而导致的，因此基础知识点的积累是很重要的。下面本文《Golang实现RPC调用详解》，就带大家讲解一下知识点，若是你对本文感兴趣，或者是想搞懂其中某个知识点，就请你继续往下看吧~

Go net/rpc 本质是TCP+Gob的同步阻塞二进制协议，支持连接复用但不跨语言；需导出类型与字段，方法签名严格为func(T,Args,*Reply)error；客户端须传已初始化指针，建议用jsonrpc替代以获HTTP/JSON优势。

Go 标准库 net/rpc 的调用流程本质是 TCP + Gob 编码

Go 自带的 rpc 包不是“类 HTTP 的远程调用”，而是一个基于连接复用、同步阻塞、单连接多请求的二进制协议栈。服务端启动后监听 TCP，客户端 dial 后复用该连接发送多个 Call 或 Go 请求，每次请求携带方法名、参数、返回值指针，由 gob 编码传输。

这意味着：不支持跨语言（除非对方也实现 Go 的 gob 协议）、不支持 HTTP 路由、无法穿透多数 HTTP 代理、默认无超时控制——这些不是 bug，是设计使然。

• rpc.Server 默认使用 gob 编解码，不自动处理 struct 字段导出规则：未导出字段（小写开头）会被静默忽略
• 服务端注册方法必须是 func(*T, *Args, *Reply) error 形式，且接收者类型 T 必须已导出（首字母大写）
• 客户端 client.Call 是同步阻塞的；若想并发发多个请求，得用 client.Go + channel 手动收结果

如何正确注册和暴露 RPC 方法

常见错误是把方法定义在非导出类型上，或参数/返回值类型没导出，导致 server.Register 不报错但调用时返回 method not found。

正确做法：

• 定义一个导出结构体，如 type Arith int（注意不是 type arith int）
• 方法必须是导出的，签名严格匹配：func (t *Arith) Multiply(args *Args, reply *Reply) error
• Args 和 Reply 类型本身必须导出，且所有字段导出（Num1 int ✅，num1 int ❌）
• 注册前确保 server := rpc.NewServer()，再 server.Register(new(Arith))，不能直接 rpc.Register（该函数操作全局 server，易冲突）

客户端调用时最常踩的三个坑

不是连不上，而是连上了却拿不到结果或 panic——问题几乎都出在指针和生命周期上。

• args 和 reply 都必须传指针：client.Call("Arith.Multiply", &args, &reply)，传值会 decode 失败并卡住
• reply 指针所指对象必须已初始化（哪怕只是 var reply Reply），否则 gob 解码时 panic “invalid memory address”
• TCP 连接未设超时，一旦服务端 hang 住，客户端 Call 会永久阻塞。务必用 net.DialTimeout 并设置 conn.SetDeadline，或改用 http.Transport 封装的 JSON-RPC（见下条）

想用 HTTP + JSON？别硬套 net/rpc，换 net/rpc/jsonrpc

标准库提供了 jsonrpc 包，它复用 net/rpc 的服务逻辑，但底层走 HTTP POST + JSON 编码。好处是能被 curl 测试、兼容 Nginx 转发、天然支持超时，缺点是每个请求新建 HTTP 连接（无法复用），性能略低。

关键差异：

• 服务端用 rpc.ServeHTTP 替代 server.Accept，配合 http.Serve
• 客户端改用 jsonrpc.NewClient 或 jsonrpc.NewClientCodec，不再用 rpc.Dial
• 方法签名不变，但参数/返回值需满足 JSON 可序列化（如 time.Time 要转 string，map key 必须是 string）
• 错误信息会以 JSON 形式返回，比如 {"error":"method not found"}，比 gob 更易调试

真正难的从来不是写通一次调用，而是理解 client 和 server 之间那根连接的状态管理、编码边界、以及错误传播路径——这些地方一漏，debug 成本远高于重写逻辑。

到这里，我们也就讲完了《Golang实现RPC调用教程详解》的内容了。个人认为，基础知识的学习和巩固，是为了更好的将其运用到项目中，欢迎关注golang学习网公众号，带你了解更多关于的知识点！