如何使用Golang实现RPC调用_Golang RPC通信方法与示例

浅婷姑娘_5018

浅婷姑娘_5018

2026-01-20

786人浏览

原创

net/rpc.Register不生效主因是注册对象非导出结构体指针、未在ServeConn前注册,且方法需大写、接收者为指针、参数返回值可gob编码,签名须为func(T,Args,*Reply)error。

如何使用golang实现rpc调用_golang rpc通信方法与示例

Go 标准库的 net/rpc 支持基于 TCP 或 HTTP 的 RPC,但默认只支持 Go 客户端调用 Go 服务端,且要求双方使用相同的编码协议(如 gob)。跨语言或生产环境建议改用 gRPC,但若只是内部轻量服务互通,net/rpc 仍可快速落地。

为什么 rpc.Register 不生效?

常见原因是注册对象不是导出(首字母大写)的结构体指针,或未在 rpc.ServeConn 前完成注册。Go 的 RPC 只能导出方法:方法名必须大写、接收者必须是指针、参数和返回值类型必须可被 gob 编码。

  • rpc.Register 必须传入指针:rpc.Register(&MyService{}),而非 rpc.Register(MyService{})
  • 服务结构体字段和方法名必须首字母大写(如 DoWork),否则无法被序列化和反射调用
  • 每个方法签名必须严格为 func(*T, *Args, *Reply) error,其中 *Args 和 *Reply 都需是导出结构体指针

如何用 HTTP 协议暴露 RPC 服务?

标准库支持将 RPC 服务挂载到 HTTP handler 上,便于调试或与反向代理集成。关键在于调用 rpc.HandleHTTP() 后启动 HTTP server,并确保监听路径为 /rpc(默认)。

  • 服务端启动时需先调用 rpc.Register,再调用 rpc.HandleHTTP()
  • HTTP 模式下,客户端必须用 rpc.DialHTTP 连接,不能用 rpc.Dial
  • HTTP handler 默认注册两个路径:/rpc(用于 RPC 调用)和 /debug/rpc(用于查看已注册方法)
package main
<p>import (
"log"
"net/http"
"net/rpc"
)</p><p>type Args struct {
A, B int
}</p><p>type Arith int</p><div class="aritcle_card flexRow artxards">
											<div class="artcardd flexRow">
												<a class="aritcle_card_img" rel="nofollow" href="/xiazai/skill10340" title="arcgis-js"><img
														src="https://img.php.cn/upload/skill/001/246/273/6adaf20e352aa140.jpg" alt="arcgis-js" onerror="this.onerror='';this.src='/static/lhimages/moren/morentu.png'" ></a>
												<div class="aritcle_card_info flexColumn">
													<a rel="nofollow" href="/xiazai/skill10340" title="arcgis-js" class="overflowclass">arcgis-js</a>
													<p class="overflowclass">提供 ArcGIS Maps SDK for JavaScript 开发辅助,涵盖 2D/3D 地图视图、图层管理、数据可视化、空间分析等功能模块的参考和示例指导。</p>
												</div>
												<a rel="nofollow" href="/xiazai/skill10340" title="arcgis-js" class="aritcle_card_btn flexRow flexcenter"><b></b><span>下载</span>
												</a>
											</div>
										</div><p>func (t <em>Arith) Multiply(args </em>Args, reply <em>int) error {
</em>reply = args.A * args.B
return nil
}</p><p>func main() {
rpc.Register(new(Arith))
rpc.HandleHTTP()
log.Fatal(http.ListenAndServe(":1234", nil))
}</p>

客户端连接失败:dial tcp: lookup xxx: no such host 是什么问题?

这是 DNS 解析失败,不是 RPC 协议问题。常见于客户端用主机名(如 "myserver:1234")连接,但宿主环境无法解析该域名。最稳妥的方式是用 IP + 端口直连,或确保 /etc/hosts 或 DNS 配置正确。

  • 检查服务端是否真实监听在对应地址:运行 netstat -tuln | grep 1234,确认是 0.0.0.0:1234 或 127.0.0.1:1234,而非仅 localhost:1234
  • 若服务端绑定的是 localhost,Docker 容器内客户端无法访问;应改用 0.0.0.0
  • 防火墙或 SELinux 可能拦截端口,临时关闭验证:sudo ufw disable(Linux)

如何让 RPC 支持 JSON 编码?

标准 net/rpc 支持插件式编解码器,只需用 rpc.NewServer() 替代全局默认 server,并注册 jsonrpc.NewServerCodec。但注意:JSON 编码不支持 Go 特有类型(如 time.Time、map[interface{}]interface{}),且方法名必须匹配 JSON 字段规则(首字母大写即为 PascalCase)。

  • 服务端需手动处理连接:接收 net.Conn 后调用 server.ServeCodec(jsonrpc.NewServerCodec(conn))
  • 客户端需用 jsonrpc.NewClientCodec 构造 codec,再传给 rpc.NewClient
  • JSON RPC 无内置 HTTP 封装,若需走 HTTP,应直接用 net/http + json 手写,或换用 gorilla/rpc

真正容易被忽略的是错误传播:RPC 方法里 panic 会导致连接中断,且错误不会透出堆栈;必须显式 return error。另外,net/rpc 没有超时控制,客户端 Call 会永久阻塞,务必用 context 包封装或自行加 channel select 超时。

golang免费学习笔记(深入):立即使用
在学习笔记中,你将探索golang的核心概念和高级技巧!

相关文章

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
golang如何定义变量
golang如何定义变量

golang定义变量的方法:1、声明变量并赋予初始值“var age int =值”;2、声明变量但不赋初始值“var age int”;3、使用短变量声明“age :=值”等等。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2024.02.23

519

5

golang有哪些数据转换方法
golang有哪些数据转换方法

golang数据转换方法:1、类型转换操作符;2、类型断言;3、字符串和数字之间的转换;4、JSON序列化和反序列化;5、使用标准库进行数据转换;6、使用第三方库进行数据转换;7、自定义数据转换函数。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2024.02.23

616

5

golang常用库有哪些
golang常用库有哪些

golang常用库有:1、标准库;2、字符串处理库;3、网络库;4、加密库;5、压缩库;6、xml和json解析库;7、日期和时间库;8、数据库操作库;9、文件操作库;10、图像处理库。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2024.02.23

1176

5

golang和python的区别是什么
golang和python的区别是什么

golang和python的区别是:1、golang是一种编译型语言,而python是一种解释型语言;2、golang天生支持并发编程,而python对并发与并行的支持相对较弱等等。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2024.03.05

791

5

golang是免费的吗
golang是免费的吗

golang是免费的。golang是google开发的一种静态强类型、编译型、并发型,并具有垃圾回收功能的开源编程语言,采用bsd开源协议。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2024.05.21

1746

6

golang结构体相关大全
golang结构体相关大全

本专题整合了golang结构体相关大全,想了解更多内容,请阅读专题下面的文章。

2025.06.09

4934

18

golang相关判断方法
golang相关判断方法

本专题整合了golang相关判断方法,想了解更详细的相关内容,请阅读下面的文章。

2025.06.10

2274

13

golang数组使用方法
golang数组使用方法

本专题整合了golang数组用法,想了解更多的相关内容,请阅读专题下面的文章。

2025.06.17

4166

17

golang数组大全
golang数组大全

本专题整合了golang数组相关问题解决方法,想了解更多相关内容,请阅读下面的文章。

2025.06.20

5206

22

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
Python uv官方安装与入门文档
Python uv官方安装与入门文档

共0课时 | 0人学习

Buffalo框架快速入门指南
Buffalo框架快速入门指南

共0课时 | 0人学习

Valgrind支持平台说明
Valgrind支持平台说明

共0课时 | 0人学习