Golang使用RPC实现程序远程调用详解

 更新时间:2026年03月15日 09:57:45   作者:我叫黑大帅  
RPC 让你在写代码时,调用另一台远程机器上的函数,就像调用本地的函数一样简单,下面小编就和大家详细介绍一下Golang如何使用RPC实现程序远程调用吧

net/rpc 则是为了让两个 Go 程序之间直接对话

RPC 让你在写代码时,调用另一台远程机器上的函数,就像调用本地的函数一样简单。

Go 标准库中的 net/rpc 目前处于冻结状态(不再增加新功能)。在现代的实际工程中,大家通常会使用 gRPCKratos 等更强大的框架。

RPC 的核心规则

net/rpc 要求你的函数必须遵守特定的签名格式,才能被远程调用。

  • 方法所属的类型必须是导出的(首字母大写)。
  • 方法本身必须是导出的(首字母大写)。
  • 方法必须有两个参数,且都必须是导出类型或内置类型。
  • 方法的第二个参数必须是指针(因为服务器要把结果写回这个指针里)。
  • 方法必须返回一个 error 类型。
func (t *T) MethodName(args T1, reply *T2) error

常用 API

服务端 API

  • rpc.Register(rcvr any): 将你的结构体注册为 RPC 服务。结构体名默认就是服务名。
  • rpc.HandleHTTP(): 如果你想让 RPC 走 HTTP 协议,调用这个注册路由。
  • rpc.Accept(lis net.Listener): 如果你想走纯 TCP 协议,用这个接收连接。

客户端 API

  • rpc.Dial(network, address string): 连接远程 RPC 服务器(比如传 "tcp", "localhost:1234")。
  • rpc.DialHTTP(network, address string): 连接走 HTTP 协议的 RPC 服务器。
  • client.Call(serviceMethod string, args any, reply any): 同步调用远程函数。程序会在这里等待结果返回。

实例:实现一个远程乘法计算器

提供方

package main

import (
	"fmt"
	"net"
	"net/rpc"
)

// 1. 定义传入的参数结构体
type Args struct {
	A, B int
}

// 2. 定义服务结构体
type MathService struct{}

// 3. 实现服务方法(严格遵守 5 条规则)
func (m *MathService) Multiply(args Args, reply *int) error {
	*reply = args.A * args.B
	fmt.Printf("服务端执行:计算 %d * %d\n", args.A, args.B)
	return nil
}

func main() {
	// 实例化服务
	math := new(MathService)

	// 注册 RPC 服务,客户端就可以通过 "MathService.Multiply" 来调用了
	rpc.Register(math)

	// 启动 TCP 监听
	listener, err := net.Listen("tcp", ":1234")
	if err != nil {
		panic(err)
	}
	fmt.Println("RPC 服务端已启动,监听端口 1234...")

	// 接收请求并处理
	rpc.Accept(listener)
}

调用方

package main

import (
	"fmt"
	"log"
	"net/rpc"
)

// 客户端 需要定义一样的参数结构体
type Args struct {
	A, B int
}

func main() {
	// 1. 拨号连接 RPC 服务器
	client, err := rpc.Dial("tcp", "localhost:1234")
	if err != nil {
		log.Fatal("拨号失败:", err)
	}
	defer client.Close()

	// 2. 准备参数和接收结果的变量
	args := Args{A: 10, B: 20}
	var reply int

	// 3. 发起调用! 第一个参数是 "结构体名.方法名"
	err = client.Call("MathService.Multiply", args, &reply)
	if err != nil {
		log.Fatal("调用失败:", err)
	}

	fmt.Printf("调用成功!结果是: %d\n", reply)
}

到此这篇关于Golang使用RPC实现程序远程调用详解的文章就介绍到这了,更多相关Go RPC远程调用内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家!

相关文章

  • Go语言文件读取的一些总结

    Go语言文件读取的一些总结

    这篇文章主要介绍了Go语言文件读取的一些总结,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友们下面随着小编来一起学习学习吧
    2020-08-08
  • go类型转换及与C的类型转换方式

    go类型转换及与C的类型转换方式

    这篇文章主要介绍了go类型转换及与C的类型转换方式,具有很好的参考价值,希望对大家有所帮助。一起跟随小编过来看看吧
    2021-05-05
  • Go语言net/http库使用详解

    Go语言net/http库使用详解

    net/http是Go语言标准库中用于处理HTTP协议的核心组件,它提供了完整HTTP客户端和服务器实现,这个包让开发者能够快速构建高性能的Web服务,无需依赖第三方框架,感兴趣的可以了解一下
    2025-10-10
  • go嵌套匿名结构体的初始化详解

    go嵌套匿名结构体的初始化详解

    这篇文章主要介绍了go嵌套匿名结构体的初始化详解,具有很好的参考价值,希望对大家有所帮助。一起跟随小编过来看看吧
    2020-12-12
  • 深入了解Go语言中的作用域和变量重声明

    深入了解Go语言中的作用域和变量重声明

    在 Go 语言中,代码块的嵌套和作用域是程序设计的关键概念之一,本文将探讨如何在 Go 语言中利用代码块的嵌套和作用域来组织代码,并介绍变量重声明的规则,感兴趣的可以了解下
    2023-11-11
  • 一文带你深入了解Go语言中的事务

    一文带你深入了解Go语言中的事务

    事务中止时,你结束事务了吗?在开发时有可能就会犯这样的错误,其问题就是你在提交事务时,如果中间有其他业务就取消操作,那么事务也关闭了吗?本文就来详细讲讲
    2023-04-04
  • 如何使用Goland IDE go mod 方式构建项目

    如何使用Goland IDE go mod 方式构建项目

    这篇文章主要介绍了如何使用Goland IDE go mod 方式构建项目,本文给大家介绍的非常详细,对大家的学习或工作具有一定的参考借鉴价值,需要的朋友可以参考下
    2020-10-10
  • 一文探索Go中的函数使用方式

    一文探索Go中的函数使用方式

    在编程中,函数是基本构建块之一,Go语言以其简洁明了的函数定义和调用语法而闻名,所以本文就来和大家聊聊Go中的函数概念及使用,感兴趣的可以了解下
    2023-09-09
  • Go语言工程实践单元测试基准测试示例详解

    Go语言工程实践单元测试基准测试示例详解

    这篇文章主要为大家介绍了Go语言工程实践单元测试基准测试示例详解,有需要的朋友可以借鉴参考下,希望能够有所帮助,祝大家多多进步,早日升职加薪
    2023-02-02
  • GO语言基本类型String和Slice,Map操作详解

    GO语言基本类型String和Slice,Map操作详解

    这篇文章主要为大家介绍了GO语言基本类型String和Slice,Map操作示例详解,有需要的朋友可以借鉴参考下,希望能够有所帮助,祝大家多多进步,早日升职加薪
    2022-08-08

最新评论