Folly性能优化补丁介绍

简体中文|English

最新消息

• 2026.09.30：发布Folly v1.1.0版本补丁，新增IOBuf TLS内存池，通过线程本地数据块复用和连续slice切分减少高QPS场景下的malloc/free。
• 2026.06.30：发布Folly v1.0.0版本补丁仓，针对Folly异步网络io框架进行io_uring优化，提升网络io的稳定性与基线io性能。

项目介绍

Folly是Meta开源的一套高性能C++11/14/17组件库，直接针对大规模、高并发、低延迟的服务器端应用场景而设计。

本项目面向Folly网络I/O和缓冲区分配路径进行性能优化。Folly v1.1.0新增IOBuf TLS内存池，仅池化数据块，不池化IOBuf对象本身。Folly v1.0.0采用io_uring混合模式：读操作使用multishot减少系统调用，写操作使用开源send保证连续写的顺序和延迟稳定性。

IOBuf TLS内存池的核心设计如下。

• 每个线程使用TLSBlockCache缓存空闲IoBufBlock，默认最多8个。
• 默认数据块大小为8KB，从current_share连续切分互不重叠的slice。
• 小容量IOBuf::create()优先复用池块；大容量、未启用或池化失败时回退到Folly原有路径。
• 复用flagsAndSharedInfo_保存池标记和块指针，不改变sizeof(IOBuf)。
• 使用ref_count和share_count分别管理块生命周期及IOBuf引用，支持clone、reserve和跨线程释放。

目录结构

fbthrift/
├── docs/                           # 文档目录
│   ├── en/                         # 英文文档 English documents
│   │   ├── api_reference.md        # API reference sheet
│   │   ├── quick_start.md          # Menu for beginners
│   │   └── release_notes.md        # Release notes
│   │
│   ├── zh/                         # 中文文档
│   │   ├── api_reference.md        # API参考
│   │   ├── quick_start.md          # 快速入门
│   │   └── release_notes.md        # 版本说明书
│   └── LICENSE
├── LICENSE
├── iouring.patch                   # Folly v1.1.0优化补丁文件
└── README.md                       # 项目介绍

版本说明

关于Folly优化补丁的版本更新情况请参见版本说明书

快速入门

关于Folly的快速入门操作指导请参见快速入门

学习文档

学习资源名称	资源简介
快速入门	提供io_uring与IOBuf TLS内存池的编译、启用和验证指导。
版本说明书	提供Folly v1.1.0版本信息、兼容性约束和特性更新。
API参考	按版本提供TLS内存池和io_uring相关接口说明。

免责声明

此代码仓参与Folly软件开源，对异步网络I/O和IOBuf内存分配路径进行性能优化。代码遵照开源软件的设计和编码风格，并保留原有分配回退路径。软件的任何漏洞与安全问题由相应上游社区根据其漏洞和安全响应机制解决，请密切关注上游社区发布的通知和版本更新。

License

Folly遵循Apache-2.0许可证，具体请参见LICENSE文件。

本项目的文档适用CC-BY 4.0许可证，具体请参见LICENSE文件。

贡献声明

欢迎大家为社区做贡献，如果使用过程中有任何问题/建议，或者需要反馈特性需求和bug报告，可以提交Issues联系我们，具体贡献方法可参考贡献指南。同时也欢迎大家在讨论专区展开讨论交流。感谢您的支持。

致谢

感谢来自社区的每一个PR，欢迎贡献Folly补丁仓！