0

0

Go 手写一个简易的 Redis 客户端(RESP协议)

冷炫風刃

冷炫風刃

发布时间:2026-02-04 09:07:02

|

905人浏览过

|

来源于php中文网

原创

RESP协议解析需先用Peek(1)识别前导符号:+/-/:/$/*/对应简单字符串、错误、整数、批量字符串、数组,$-1和-1表示null,$N后读N字节+\r\n,N递归解析N项,须处理半包粘包及io.ErrUnexpectedEOF。

go 手写一个简易的 redis 客户端(resp协议)

RESP 协议解析的核心是识别前导符号

Redis 使用 RESP(REdis Serialization Protocol)传输数据,不是 JSON 也不是纯文本。客户端必须能根据首字节区分类型:+(简单字符串)、-(错误)、:(整数)、$(批量字符串)、*(数组)。忽略这个规则,直接 bufio.ReadString('\n') 读取会卡死或解析错乱。

实操建议:

  • bufio.Reader.Peek(1) 先看第一个字节,再决定后续读法
  • $-1 表示 null bulk string,*-1 表示 null array,必须支持,否则 GET missing_key 会解析失败
  • 批量字符串长度后跟 \r\n,内容本身不包含 \r\n,但可能含任意二进制字节——别用 strings.Split 处理

写入命令必须严格遵循 RESP 编码格式

Go 标准库没有内置 RESP 编码器,手写时容易漏掉 \r\n 或错用换行。比如 SET key value 对应的 wire format 是:

*3\r\n$3\r\nSET\r\n$3\r\nkey\r\n$5\r\nvalue\r\n

常见错误:

  • \n 替代 \r\n → Redis 返回 Protocol error: expected '\r\n'.
  • 字符串长度没转成十进制 ASCII(如写 $3 而非 $0x3)→ 实际必须是 $3,不是十六进制
  • 数组项数量写错:比如传了 4 个参数却写 *3 → Redis 静默截断或报错

连接与读写需处理半包和粘包

网络 IO 不保证一次 Read() 拿到完整 RESP 帧。例如一个 *2\r\n\r\nGET\r\n\r\nfoo\r\n 可能被分两次到达。不能假设 reader.ReadString('\n') 就能拿到完整行——因为 $ 类型的内容里可能有换行(虽然 Redis 命令值一般不含,但协议允许)。

Flowstep
Flowstep

AI界面设计工具,通过对话几秒内创建UI设计图、线框图和流程图

下载

正确做法:

  • $N 类型,先读出 N,再调用 io.ReadFull(reader, buf[:N]) 确保读满
  • *N 类型,递归解析 N 个子项,每项都按自身前导符处理
  • net.Conn.SetReadDeadline() 防止阻塞,尤其在解析 $ 后等待内容时

支持基本命令只需实现 5 种响应类型解析

不需要一开始就兼容所有 Redis 类型。先跑通 SET/GET/PING 就够验证链路。对应 RESP 解析分支只有:

  • + → 读到 \r\n 前为止,作为 string(如 +OK\r\n
  • - → 同上,但存为 error(如 -ERR unknown command 'xxx'\r\n
  • : → 读整数,如 :1000\r\nint64(1000)
  • $N → 若 N == -1 返回 nil;否则读 N 字节 + \r\n
  • *N → 若 N == -1 返回 nil;否则递归解析 N 个项,合并为 []interface{}

真正容易被忽略的是错误传播:比如 $ 后读不满 N 字节,io.ReadFull 返回 io.ErrUnexpectedEOF,这必须原样返回,不能吞掉或转成空字符串——否则上层无法区分“键不存在”和“网络中断”。

热门AI工具

更多
DeepSeek
DeepSeek

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

豆包大模型
豆包大模型

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

通义千问
通义千问

阿里巴巴推出的全能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 :=值”等等。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

184

2024.02.23

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

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

231

2024.02.23

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

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

344

2024.02.23

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

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

210

2024.03.05

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

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

397

2024.05.21

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

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

282

2025.06.09

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

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

196

2025.06.10

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

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

561

2025.06.17

全国统一发票查询平台入口合集
全国统一发票查询平台入口合集

本专题整合了全国统一发票查询入口地址合集,阅读专题下面的文章了解更多详细入口。

19

2026.02.03

热门下载

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

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
进程与SOCKET
进程与SOCKET

共6课时 | 0.4万人学习

Redis+MySQL数据库面试教程
Redis+MySQL数据库面试教程

共72课时 | 6.5万人学习

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

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