Skip to content

手写 Reactor 网络库 ​

从零实现的 C++ TCP 网络库,目的是让业务代码只关心「连接来了、消息到了、连接断了」,把 epoll、fd、粘包半包封装起来。它采用 epoll + 多线程 Reactor:主线程 accept、IO 线程收发、线程池跑业务,把 muduo 的核心链路完整走了一遍;价值在于后续自研 RPC 和视频平台直接复用了这套模型并针对具体业务做了优化。

技术栈:C++11/14 · epoll · Makefile / CMake · Linux

模块划分 ​

组件职责
TcpServer应用层入口,管理连接与线程池
EventLoopReactor 核心,事件循环
Epoll封装 epoll_create/ctl/wait
Channelfd 与事件回调的绑定
Acceptor监听套接字,接收新连接
Connection单条 TCP 连接的状态与收发
Buffer应用层读写缓冲,处理粘包
ThreadPool任务队列与工作线程
Socket / InetAddress / TimestampRAII 与基础类型

线程模型 ​

text
主线程:Acceptor 接收连接
IO 线程:EventLoop 监听 fd,读写数据
工作线程:ThreadPool 执行业务,结果交回 IO 线程发送

值得看的设计 ​

  • Reactor 从 0 实现:把「注册事件 → epoll_wait → 分发回调」这条链完整写了一遍,ET/LT 差异和 EAGAIN 处理有实际踩坑。
  • 连接生命周期:用 shared_ptr + enable_shared_from_this 管理 Connection,回调里捕获弱引用/共享引用,避免连接释放后回调访问悬空对象。
  • Buffer 自动扩容:读写位置分离,剩余空间不足时搬移或扩容,上层不用关心 TCP 流边界。
  • IO 与业务解耦:耗时任务不占 IO 线程,避免一个慢请求拖住整条 loop。

局限 ​

这是学习型网络库,不是生产轮子:没有定时器、没有 HTTP 协议解析、日志与构建体系也偏简单。它的价值在于把 Reactor 的每个环节亲手实现了一遍;后续的 wevix_muduo 在这个模型上补齐了事件唤醒、定时器、连接级 codec、双模式线程池和背压。

源码 ​

GitHub · cpp-network-library