Netty 通过 FastThreadLocal、InternalThreadLocalMap、Recycler 和 PooledByteBufAllocator 四层机制系统优化线程本地存储与对象复用：FastThreadLocal 用数组索引替代哈希查找，InternalThreadLocalMap 内置对象缓存并自动降级，Recycler 构建线程局部回收栈实现对象闭环复用，PooledByteBufAllocator 在内存分配层提供三级缓存复用 ByteBuf。
Java 原生 ThreadLocal 在高并发网络框架中容易成为性能瓶颈，Netty 通过 FastThreadLocal 和配套机制系统性优化了对象复用与内存分配，核心不是“替换 ThreadLocal”，而是重构线程本地存储的底层模型。
FastThreadLocal：用数组索引代替哈希查找
原生 ThreadLocal 依赖 ThreadLocalMap（基于线性探测的哈希表），访问需计算 hash、处理冲突、可能遍历多个槽位。FastThreadLocal 改为预分配全局唯一索引（AtomicInteger 自增），每个实例对应一个固定数组下标：
- 线程内访问直接查
InternalThreadLocalMap.indexedVariables[i]，跳过 hash 计算和探测，接近 O(1) 稳定耗时 - 避免哈希冲突导致的性能抖动，尤其在大量 FastThreadLocal 实例共存时优势明显
- 数组元素为强引用，不引入弱引用 Key 带来的清理负担和内存泄漏风险
InternalThreadLocalMap：线程级缓存 + 预分配对象池
InternalThreadLocalMap 是 FastThreadLocal 的真正容器，它不只是个 Map，还承担对象复用职责：
java-api-doc-generator
下载
分析 Java Spring Boot 后端 Controller 代码，自动生成 Markdown 格式的接口文档。当用户说“生成 Java 接口文档”、“生成 API 文档”、“从 Spring 代码生成文档”时触发。
- 作为
FastThreadLocalThread的成员变量直接持有，免去ThreadLocal.get()的间接调用开销 - 内置常用对象缓存：如
StringBuilder、ArrayList、CharsetEncoder/Decoder，首次使用时创建并复用，避免重复 new - 对普通线程（非 FastThreadLocalThread）自动降级为标准
ThreadLocal，保障兼容性
Recycler + FastThreadLocal：线程局部对象池闭环
Netty 中高频创建/销毁的对象（如 ChannelHandler、ByteBuf、Runnable）不靠 ThreadLocal 存副本，而是用 Recycler 构建线程局部堆栈：
-
Recycler内部用FastThreadLocal管理每个线程专属的回收栈> - 对象使用完后调用
handle.recycle()，直接压入当前线程的 Stack，下次get()优先弹出复用 - 避免跨线程共享、无需同步、无 GC 压力，比单纯 ThreadLocal 存对象更轻量且可控
PooledByteBufAllocator：内存分配层的三级复用
对于字节缓冲区这类最频繁分配的对象，Netty 将复用下沉到内存分配器层面：
- 启用
PooledByteBufAllocator后，buffer()不再新建对象，而是从线程局部PoolThreadCache获取已分配好的ByteBuf - 三级结构：线程缓存（无锁）→ Arena 共享队列（轻量锁）→ Chunk 分页（仅首次或扩容触发）
- 必须显式
buf.release()才能归还，否则仍走 GC 路径；配合-Dio.netty.leakDetectionLevel=paranoid可定位未释放点
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
