第13章 客户端

为什么从“客户端缓冲与生命周期台”开始

第13章 客户端的核心任务是检查redisClient的套接字、名字、标志、输入输出缓冲、命令参数、事务与复制状态。命令返回值只暴露外层合同；实现解释还必须连接内存结构、写入与读取路径、事件顺序以及失败后的旧状态回收。客户端缓冲与生命周期台把这些关系放进同一条可复位轨迹。

先写预测：当输入输出量由“流水请求”进入“慢消费者”时，哪个可观察状态最先变化？再规定什么结果会推翻当前解释。交互中的分数只表达透明因果方向，不冒充真实Redis测量。

来源、版次与独立重写边界

黄健宏作者读者服务页确认正式出版新版以Redis 3.0为源码基线，列出4部分、24章及完整小节，并链接Redis 3.0中文注释源码。本课程据此映射24个正式单元、145个目录节点，另设学习地图和总复习；未取得出版正文授权，目录只界定范围，不宣称复现原书正文。

本章字段与控制流由Redis官方3.0源码：networking.c和作者注释源码交叉核对；Redis当前持久化文档只用于辨认版本差异。中文解释、图示、交互、实验与答案均为独立教学重写，不把目录页或代码仓库许可证误报为原书许可证。

本章术语与源码合同

第13章 客户端必须守住“客户端生命周期与套接字一致，缓冲区有上界，关闭路径清理订阅、监视和事务状态”。观察同时记录客户端缓冲与生命周期台一致率与客户端状态分叉风险；只有结构快照、函数入口、运行结果和故障反例互相一致，才接受实现结论。

作者目录逐项深读

客户端属性

四级证据 1/3。 redisClient聚合fd、选择库、参数、命令、查询与回复缓冲、flags以及事务/订阅/复制等状态。本节点用“客户端属性”作观察点，执行rg 'createClient|freeClient|sendReplyToClient' src/networking.c或等价源码探针，保存版本、输入、前后状态和能推翻解释的反例。

验证客户端属性时，先预测输入输出量从“流水请求”切到“慢消费者”会改变哪个字段、偏移、文件或消息；再固定客户端状态做一次对照。若故障注入没有破坏“客户端生命周期与套接字一致，缓冲区有上界，关闭路径清理订阅、监视和事务状态”，就撤回当前解释而不是补写故事。

客户端的创建与关闭

四级证据 2/3。 创建要注册读事件并初始化缓冲；关闭要注销事件、释放回复与参数并解除订阅、WATCH和阻塞状态。本节点用“客户端的创建与关闭”作观察点，执行rg 'createClient|freeClient|sendReplyToClient' src/networking.c或等价源码探针，保存版本、输入、前后状态和能推翻解释的反例。

验证客户端的创建与关闭时，先预测输入输出量从“流水请求”切到“慢消费者”会改变哪个字段、偏移、文件或消息；再固定客户端状态做一次对照。若故障注入没有破坏“客户端生命周期与套接字一致，缓冲区有上界，关闭路径清理订阅、监视和事务状态”，就撤回当前解释而不是补写故事。

重点回顾

四级证据 3/3。 第13章 客户端的回顾要重新证明“客户端生命周期与套接字一致，缓冲区有上界，关闭路径清理订阅、监视和事务状态”，并用同一输入比较结构前态、变更轨迹、故障首错与恢复后态

验证重点回顾时，先预测输入输出量从“流水请求”切到“慢消费者”会改变哪个字段、偏移、文件或消息；再固定客户端状态做一次对照。若故障注入没有破坏“客户端生命周期与套接字一致，缓冲区有上界，关闭路径清理订阅、监视和事务状态”，就撤回当前解释而不是补写故事。

最小源码与运行切片

+git clone --branch 3.0 --depth 1 https://github.com/redis/redis.git redis-3.0
+cd redis-3.0
+rg 'createClient|freeClient|sendReplyToClient' src/networking.c

该切片固定Redis 3.0分支、编译器、配置、数据集和命令序列；先保存结构或函数位置，再运行隔离实例。任何持久化损坏、断线、故障转移、大键或高流量实验都必须使用临时数据并规定CPU、内存、磁盘、延迟和停止上限。

unit: rdi-13-client
source_file: networking.c
axis_a: "输入输出量"
axis_b: "客户端状态"
fault: "关闭套接字却遗留WATCH、订阅或输出缓冲关系，造成资源与状态泄漏"
invariant: "客户端生命周期与套接字一致，缓冲区有上界，关闭路径清理订阅、监视和事务状态"
replay: same_version_same_input

三个必须主动触发的误区

误区 1

现象 → 慢消费者不限制 原因 → 输出缓冲撑爆内存 修法 → 配置 output-buffer-limit 分类限流

误区 2

现象 → Pipeline 塞太多命令 原因 → 输入缓冲与执行时间膨胀 修法 → 控制单批命令数量

误区 3

现象 → 空闲连接不清理 原因 → 连接数耗尽拒新连接 修法 → 设 timeout 并监控连接数

小结

• 客户端状态由结构体统一维护
• 输入缓冲区解析命令
• 输出缓冲区分固定与可变
• 阻塞与关闭条件要明确
• 伪客户端承载复制与 AOF

练习、答案与节点验证

术语复核与本章回顾

完成第13章 客户端意味着能从networking.c解释检查redisClient的套接字、名字、标志、输入输出缓冲、命令参数、事务与复制状态，能运行章专属状态实验，能制造反例并在复位后证明旧状态没有残留。