0

0

如何使用Golang实现RPC序列化与反序列化_Golang RPC数据编码与解码方法

P粉602998670

P粉602998670

发布时间:2026-01-01 19:45:09

|

516人浏览过

|

来源于php中文网

原创

net/rpc 默认用 gob,不支持跨语言;换 JSON 需用 jsonrpc 包并调用 jsonrpc.ServeConn;换 protobuf 应直接用 gRPC;自定义 ServerCodec 必须处理分帧、Header 解析和错误传播。

如何使用golang实现rpc序列化与反序列化_golang rpc数据编码与解码方法

Go 标准库net/rpc 默认使用 gob 编码,不支持跨语言、不兼容 JSON 或 Protocol Buffers——如果你需要自定义序列化(比如用 jsonprotobuf),必须绕过默认机制,自己接管编解码流程。

为什么不能直接替换 rpc.Server 的编解码器?

标准 rpc.Serverrpc.Client 将编码/解码深度耦合在 rpc.Server.ServeCodecrpc.NewClientWithCodec 中,底层依赖 rpc.ServerCodec 接口。它要求你同时实现 ReadRequestHeader/ReadRequestBodyWriteResponse 等方法,不能只换一个序列化格式。

常见错误是试图“简单替换 gobjson”,结果发现请求头读不出来、响应乱序、或连接直接断开——因为 json 没有 gob 那样的类型元信息和流式分帧能力。

  • gob 自带类型描述、支持指针/接口/循环引用,且天然适配 Go 运行时;json 是纯文本、无类型、需显式结构体标签
  • RPC 协议不是“发一串 JSON 就完事”,它需要严格区分 header(含方法名、序列号)和 body(参数),而 json 不提供内置分界机制
  • 标准 rpc/jsonrpc 包只是对 gob 编解码逻辑的重写,并非“用 encoding/json 替代 gob”——它仍遵循 RPC 帧格式约定

如何用 json 实现兼容标准 rpc.Client 的服务端?

使用 net/rpc/jsonrpc 是最轻量、最兼容的方式:它复用了标准 rpc 的注册与调用逻辑,仅替换底层编解码器。客户端无需改代码,只要把 rpc.NewClient 换成 jsonrpc.NewClient 即可。

立即学习go语言免费学习笔记(深入)”;

服务端启动示例:

package main
<p>import (
"net"
"net/rpc"
"net/rpc/jsonrpc"
)</p><p>type Args struct{ A, B int }
type Quotient struct{ Quo, Rem int }</p><p>type Arith int</p><div class="aritcle_card flexRow">
                                                        <div class="artcardd flexRow">
                                                                <a class="aritcle_card_img" href="/ai/1618" title="吐槽大师"><img
                                                                                src="https://img.php.cn/upload/ai_manual/000/000/000/175680269472051.png" alt="吐槽大师"  onerror="this.onerror='';this.src='/static/lhimages/moren/morentu.png'" ></a>
                                                                <div class="aritcle_card_info flexColumn">
                                                                        <a href="/ai/1618" title="吐槽大师">吐槽大师</a>
                                                                        <p>吐槽大师(Roast Master) - 终极 AI 吐槽生成器,适用于 Instagram,Facebook,Twitter,Threads 和 Linkedin</p>
                                                                </div>
                                                                <a href="/ai/1618" title="吐槽大师" 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))
listener, <em> := net.Listen("tcp", ":1234")
for {
conn, </em> := listener.Accept()
go jsonrpc.ServeConn(conn) // ← 关键:用 jsonrpc.ServeConn 替代 rpc.ServeConn
}
}

注意点:

  • 必须用 jsonrpc.ServeConn 启动连接,不能用 rpc.ServeConn
  • 客户端必须用 jsonrpc.NewClientjsonrpc.Dial,否则会因帧格式不匹配而报 invalid character 错误
  • 结构体字段必须首字母大写(导出),且建议加 json: 标签以控制 key 名

如何用 protobuf + gRPC 替代原生 net/rpc

如果你真正想要的是高性能、跨语言、带 IDL 的 RPC,不要硬改 net/rpc,直接用 gRPC-Go。它本质是基于 HTTP/2 的二进制 RPC 框架,protobuf 是其默认序列化协议,天然支持 streaming、拦截器、超时、认证等。

关键区别:

  • net/rpc 是 TCP + 自定义二进制帧(gob)或 JSON 帧;gRPC 是 HTTP/2 + protobuf + gRPC-encoding(length-delimited)
  • gRPC 要求先写 .proto 文件生成 Go 代码;net/rpc 直接注册结构体和方法
  • 没有 gRPC 服务端,protobuf 只是序列化工具——你仍需自己设计传输层(比如用 net.Conn + 自定义分帧),这极易出错

所以,除非你有强约束(如必须复用现有 net/rpc 客户端、不能引入新协议),否则别尝试“给 net/rpc 换 protobuf 底层”。真要这么做,得完整实现 rpc.ServerCodec,包括:ReadRequestHeader 解析 method/service/seq,ReadRequestBodyproto.Unmarshal,还要处理 length-prefix framing——这已接近重写整个 RPC 栈。

自定义编解码器时最容易忽略的细节

当你实现自己的 rpc.ServerCodec,以下三点几乎必踩坑:

  • TCP 是字节流,没有消息边界——必须自己加长度前缀(如 4 字节 uint32 表示后续 payload 长度),否则 ReadRequestBody 会阻塞或读错数据
  • ReadRequestHeader 必须严格按 RPC 协议解析出 ServiceMethod 字符串(格式为 "Service.Method")和 Seq(请求序号),漏掉任一字段会导致客户端永远收不到响应
  • WriteResponseerr 参数不能忽略:如果业务逻辑返回 error,必须写入 response body 并设置 ErrorResponse 标志,否则客户端 Call 会卡死或 panic

真正稳定的自定义方案,往往不是从零写 ServerCodec,而是基于 gRPCCodec 接口或 go-microcodec 插件机制——它们已封装好分帧、上下文、错误传播等细节。

热门AI工具

更多
DeepSeek
DeepSeek

幻方量化公司旗下的开源大模型平台

豆包大模型
豆包大模型

字节跳动自主研发的一系列大型语言模型

WorkBuddy
WorkBuddy

腾讯云推出的AI原生桌面智能体工作台

腾讯元宝
腾讯元宝

腾讯混元平台推出的AI助手

文心一言
文心一言

文心一言是百度开发的AI聊天机器人,通过对话可以生成各种形式的内容。

讯飞写作
讯飞写作

基于讯飞星火大模型的AI写作工具,可以快速生成新闻稿件、品宣文案、工作总结、心得体会等各种文文稿

即梦AI
即梦AI

一站式AI创作平台,免费AI图片和视频生成。

ChatGPT
ChatGPT

最最强大的AI聊天机器人程序,ChatGPT不单是聊天机器人,还能进行撰写邮件、视频脚本、文案、翻译、代码等任务。

相关专题

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

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

211

2024.02.23

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

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

247

2024.02.23

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

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

356

2024.02.23

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

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

214

2024.03.05

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

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

409

2024.05.21

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

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

490

2025.06.09

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

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

201

2025.06.10

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

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

1479

2025.06.17

TypeScript类型系统进阶与大型前端项目实践
TypeScript类型系统进阶与大型前端项目实践

本专题围绕 TypeScript 在大型前端项目中的应用展开,深入讲解类型系统设计与工程化开发方法。内容包括泛型与高级类型、类型推断机制、声明文件编写、模块化结构设计以及代码规范管理。通过真实项目案例分析,帮助开发者构建类型安全、结构清晰、易维护的前端工程体系,提高团队协作效率与代码质量。

26

2026.03.13

热门下载

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

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
WEB前端教程【HTML5+CSS3+JS】
WEB前端教程【HTML5+CSS3+JS】

共101课时 | 10.2万人学习

JS进阶与BootStrap学习
JS进阶与BootStrap学习

共39课时 | 3.4万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号