技术学院

如何在Golang中实现RPC调用_Golang RPC客户端与服务器调用示例

作者:P粉6029986702026-01-09 00:00:00

不能直接用于生产环境。net/rpc 默认用 Gob 编码、不跨语言、需手动封装 HTTP、缺乏超时/重试/服务发现，仅适合学习或内网轻量通信，上线前应评估替换为 gRPC 等成熟方案。

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。