Golang实现RPC调用教程

本文深入剖析了 Go 标准库 `net/rpc` 的实际能力与严重局限：它虽能快速实现轻量级内网通信或教学演示，但因默认依赖 Gob 编码、不支持跨语言、缺乏超时控制、重试机制、服务发现和可观测性等关键生产特性，**完全不可直接用于线上环境**；文章不仅指出常见陷阱（如方法签名不规范导致静默注册失败、连接拒绝的排查要点），还手把手演示了服务端注册、客户端调用及手动实现超时的典型模式，最终明确呼吁——真正项目应尽早评估迁移至 gRPC、Dubbo-Go 或标准化 HTTP/JSON 方案，避免将教学工具误作生产基础设施。

Go 标准库 net/rpc 能否直接用于生产环境？

不能直接用于生产。标准库 net/rpc 默认使用 Gob 编码，不跨语言，HTTP 传输层需手动封装，且缺乏超时控制、重试、服务发现等能力。它适合学习 RPC 原理或内网轻量模块间通信，但上线前应评估是否替换为 gRPC、Dubbo-Go 或基于 HTTP/JSON 的自定义方案。

用 net/rpc 实现最简服务端需注意哪些关键点？

服务端必须满足三个硬性条件：结构体字段首字母大写（导出）、方法签名固定为 func(*T, *Args, *Reply) error、方法必须是导出的（首字母大写）。否则注册会静默失败，客户端调用时返回 rpc: can't find service Method。

• Args 和 Reply 类型必须可被 Gob 编码（即字段可导出，且类型支持）
• 服务注册必须在 http.Serve 或 rpc.Accept 启动前完成
• 若用 HTTP 传输，需显式调用 rpc.HandleHTTP()，并确保监听端口未被占用

package main
import (
"log"
"net/http"
"net/rpc"
)
type Args struct {
A, B int
}
type Arith int
func (t Arith) Multiply(args Args, reply int) error {
reply = args.A * args.B
return nil
}
func main() {
rpc.Register(new(Arith))
rpc.HandleHTTP()
log.Fatal(http.ListenAndServe(":1234", nil))
}

客户端调用时为什么总卡住或报 dial tcp :1234: connect: connection refused？

这是最常见的连接问题，根本原因不是代码写错，而是服务端没真正跑起来，或监听地址不对。检查三件事：

• 服务端进程是否仍在运行（ps aux | grep 1234）
• 服务端监听的是 :1234 还是 127.0.0.1:1234？客户端 rpc.DialHTTP("tcp", "127.0.0.1:1234") 中地址必须严格匹配
• 防火墙或 Docker 网络是否拦截了端口（本地测试建议先关防火墙或用 curl http://127.0.0.1:1234/debug/rpc 验证 HTTP handler 是否生效）

package main
import (
"log"
"net/rpc"
)
func main() {
client, err := rpc.DialHTTP("tcp", "127.0.0.1:1234")
if err != nil {
log.Fatal(err) // 注意：这里会直接 panic，实际应加 context.WithTimeout
}
defer client.Close()
args := &Args{7, 8}
var reply int
err = client.Call("Arith.Multiply", args, &reply)
if err != nil {
    log.Fatal(err)
}
log.Printf("Result: %d", reply)
}

如何给 rpc.Client.Call 加超时和上下文控制？

标准 net/rpc 不原生支持 context，但可通过封装底层连接实现。最稳妥的方式是用 net.DialTimeout 控制建连阶段，再对 Call 使用 time.AfterFunc 或启动 goroutine + channel 超时判断。更推荐升级到 golang.org/x/net/context 兼容的封装库，或直接迁移到 gRPC。

• 建连超时：用 rpc.DialHTTPPath + 自定义 http.Transport 设置 DialContext
• 调用超时：必须自己实现 channel select 模式，无法复用 context.Context 的取消链
• 不要依赖 client.Close() 触发超时清理；超时后应主动 cancel() 并丢弃该 client 实例

跨语言互通、负载均衡、可观测性这些需求，从一开始就不该指望 net/rpc 解决。它只是 Go 的一个教学级参考实现，别把它当基础设施用。

好了，本文到此结束，带大家了解了《Golang实现RPC调用教程》，希望本文对你有所帮助！关注golang学习网公众号，给大家分享更多Golang知识！