go语言 rpc 需服务端注册导出 结构体 方法(签名 func(T,Args,*Reply)Error)、客户端用 Dial/Dialhttp连接并 Call 调用,依赖 Gob编码 要求类型导出且不含不可序列化字段。

Go 语言 内置的 net/rpc 包提供了简洁的 RPC(远程过程调用)支持,基于 HTTP 或 TCP 协议,使用 Gob编码 ,默认仅支持导出方法(首字母大写)和特定签名。要实现可用的 RPC 客户端与服务端,关键在于: 接口 定义清晰、服务注册正确、连接可靠、错误处理到位。
服务端:注册结构体方法并启动监听
服务端需定义一个导出的结构体,并为其添加符合 RPC 要求的方法(接收者为 指针,参数与返回值均为导出类型,且第二个参数必须是指针)。
- 方法签名必须是
func(*T, *Args, *Reply) error - 将结构体实例注册为服务:
rpc.registerName("Arith", new(Arith)) - 选择传输协议:用
rpc.ServeConn处理单个连接,或用rpc.HandleHTTP+http.Serve启用 HTTP 方式(更易调试)
示例中常用 http.DefaultServeMux 配合 rpc.HandleHTTP(),然后监听 8080 端口 即可对外提供 RPC 服务。
客户端:建立连接并调用远程方法
客户端通过 rpc.Dial 或rpc.DialHTTP连接服务端,得到 *rpc.Client 实例后,即可用 Call 或Go发起同步 /异步 调用。
立即学习“go 语言免费学习笔记(深入)”;
- 若服务端走 HTTP,客户端必须用
rpc.DialHTTP();若服务端用 TCP 裸连,则用rpc.Dial("tcp", "127.0.0.1:8080") -
client.Call("Arith.Multiply", args, &reply)中服务名 + 方法名需与服务端注册一致 - 务必检查返回的
error,网络失败、方法未找到、编解码错误都会在这里体现
数据类型 与序列化注意事项
Go RPC 默认使用 Gob 编码,要求所有传输字段和类型都必须是导出的(首字母大写),且不能含 func、channel、unsafe.pointer等不可序列化类型。
- 建议定义独立的
Args和Reply结构体,显式控制入参与返回结构 - 避免直接传指针或 map/slice 的别名类型,除非已用
gob.Register显式注册 - 如需 jsON 或自定义编码,可 封装
ClientCodec/ServerCodec,但会失去原生便利性
常见问题 与调试建议
开发时容易卡在连接不通、方法调用返回 method not found 或EOF,多数源于路径不匹配或类型未导出。
- 用
curl http://127.0.0.1:8080/debug/rpc查看已注册服务列表(HTTP 模式下) - 确保服务端启动后没有 panic,客户端连接前先
ping或telnet确认 端口 可达 - 日志中打印
err详情,特别是client.Call返回的 error,常含具体失败原因
基本上就这些。不复杂但容易忽略导出规则和协议一致性,写完跑通一次,后续扩展就顺了。