当前位置：首页 > news >正文

Go 中 RPC 的使用教程

news 2025/11/5 19:32:58

前言

RPC（Remote Procedure Call）是一种允许程序调用远程服务器上函数的方法，调用过程对于开发者来说像是调用本地函数一样方便。Go 语言自带了强大的 net/rpc 库，能够让开发者轻松实现基于 Go 的 RPC 服务。本文将介绍 Go 中 RPC 的使用方法，并通过简单示例展示如何搭建 RPC 服务和客户端。

一、什么是 RPC？

RPC（远程过程调用）是一种跨网络通信协议，允许程序在不同的主机上执行代码而不需要明确处理底层网络通信。使用 RPC，开发者只需编写服务端的逻辑，然后客户端可以像调用本地函数一样调用服务端的函数，底层的网络传输、序列化和反序列化都由 RPC 框架处理。

在 Go 中，RPC 是通过 net/rpc 包实现的，Go 标准库还支持 JSON-RPC 和 HTTP 传输协议。

二、Go 中 RPC 的基本原理

Go 中的 RPC 框架遵循以下几条规则：

服务对象是公开的结构体类型。
服务对象的方法必须是公开的，并且方法必须有两个参数和一个返回值。第一个参数是输入参数，第二个参数是指针类型用于接收返回结果，返回值是 error 类型。
客户端通过 net/rpc 库向服务端发出请求，服务端执行对应的函数，返回结果。

三、Go 中 RPC 的使用步骤

1. 定义服务

首先，我们需要定义一个服务。这个服务是一个 Go 结构体，其中包含一些方法供客户端调用。

package mainimport ("errors""net""net/rpc""fmt"
)// 定义服务结构体
type Arith struct{}// 定义输入参数
type Args struct {A, B int
}// 定义服务方法
func (t *Arith) Multiply(args *Args, reply *int) error {*reply = args.A * args.Breturn nil
}func (t *Arith) Divide(args *Args, reply *int) error {if args.B == 0 {return errors.New("divide by zero")}*reply = args.A / args.Breturn nil
}

在上面的代码中，我们定义了 Arith 结构体，它有两个方法 Multiply 和 Divide，分别用于乘法和除法运算。

2. 启动 RPC 服务

接下来，我们需要启动一个 RPC 服务器，让客户端可以通过网络调用这个服务。

func main() {arith := new(Arith)rpc.Register(arith)  // 注册服务listener, err := net.Listen("tcp", ":1234")  // 监听端口if err != nil {fmt.Println("Error starting server:", err)}fmt.Println("Server is listening on port 1234...")for {conn, err := listener.Accept()  // 接收连接if err != nil {fmt.Println("Error accepting connection:", err)continue}go rpc.ServeConn(conn)  // 使用 goroutine 处理每个连接}
}

这段代码启动了一个监听在 1234 端口的 RPC 服务器。每当有客户端请求连接时，服务器会处理该连接并执行相应的 RPC 方法。

3. 创建 RPC 客户端

服务端已经准备好了，接下来我们需要编写客户端代码，客户端将通过 RPC 远程调用服务端的函数。

package mainimport ("fmt""log""net/rpc"
)type Args struct {A, B int
}func main() {client, err := rpc.Dial("tcp", "localhost:1234")  // 连接服务端if err != nil {log.Fatal("dialing:", err)}// 调用 Multiply 方法args := Args{A: 7, B: 8}var reply interr = client.Call("Arith.Multiply", args, &reply)if err != nil {log.Fatal("arith error:", err)}fmt.Printf("Arith: %d * %d = %d\n", args.A, args.B, reply)// 调用 Divide 方法args = Args{A: 10, B: 2}err = client.Call("Arith.Divide", args, &reply)if err != nil {log.Fatal("arith error:", err)}fmt.Printf("Arith: %d / %d = %d\n", args.A, args.B, reply)
}

在这段代码中，客户端首先通过 rpc.Dial 函数连接到服务端。连接建立后，客户端调用远程的 Multiply 和 Divide 方法，并输出结果。

4. 运行程序

首先在一个终端启动服务端：

go run server.go

然后在另一个终端运行客户端：

go run client.go

运行后，客户端会输出类似以下内容：

Arith: 7 * 8 = 56
Arith: 10 / 2 = 5

四、Go 中的 RPC 进阶

1. 异步调用

Go 的 RPC 框架支持异步调用，可以通过 Go 方法实现。它会返回一个 Call 对象，通过该对象可以获取异步调用的结果。

call := client.Go("Arith.Multiply", args, &reply, nil)
replyCall := <-call.Done  // 等待结果
fmt.Printf("Async result: %d * %d = %d\n", args.A, args.B, replyCall.Reply)

2. 使用 HTTP 作为传输协议

Go 也支持通过 HTTP 协议进行 RPC 通信，只需稍加配置：

rpc.HandleHTTP()
listener, err := net.Listen("tcp", ":1234")
go http.Serve(listener, nil)

在客户端中，通过 rpc.DialHTTP 连接服务端：

client, err := rpc.DialHTTP("tcp", "localhost:1234")

五、总结

通过 net/rpc，Go 提供了一个简单而高效的 RPC 实现。它让开发者可以轻松地构建分布式系统，并且底层的通信和序列化都由库自动处理，极大地降低了开发复杂性。本文通过一个简单的示例展示了如何在 Go 中使用 RPC，希望能为你的开发提供帮助。

前言