Netty中ByteBuf泄漏的根源是引用计数（refCnt）未归零，导致Netty误判“仍有引用”而不回收；需由最后持有者显式调用release()，常见于channelRead()入参未释放、异常路径遗漏、writeAndFlush后误手动释放及retain未配对release等场景。
Netty 中 ByteBuf 泄漏的常见根源，是引用计数（refCnt）本该归零却未归零，导致对象无法被回收。这不是内存没释放，而是 Netty 认为“还有人在用”，于是不触发清理逻辑——本质是引用计数管理失当，而非 JVM 堆内存泄漏本身。
谁该调用 release()？明确责任边界
Netty 要求最后持有并使用完 ByteBuf 的组件负责释放。典型场景中：
- 在
ChannelInboundHandler的channelRead()中接收到的ByteBuf，默认由框架传递给你，你处理完必须显式release()（除非你把它传给下一个 handler 或写回 channel） - 你自己通过
alloc().buffer()创建的ByteBuf，必须自己释放 - 调用
writeAndFlush(buf)后，Netty 会接管该 buf 并在写入完成后自动释放——你不能再手动 release，否则可能 double-release - 若在 handler 中对入参
msg做了retain()（比如缓存、异步处理），那对应位置就必须配对release()
常见归零失败的典型模式
以下写法极易导致 refCnt 残留 > 0：
-
忘记释放入参 ByteBuf：在
channelRead()中只读取内容，未调用msg.release()，且未ctx.fireChannelRead(msg)向后传递 - 异常路径遗漏 release：try-catch 中只在正常流程 release，但 catch 块未兜底释放，导致异常时泄漏
-
误判所有权转移：调用
ctx.write(buf)后又自行buf.release()；或调用writeAndFlush()后还 retain+release，打乱 Netty 内部计数节奏 -
共享 buf 未同步计数：多个线程或模块共用一个 buf，但只有部分方调用
retain()，却没有全部参与release()协作
快速定位 refCnt 异常的实用手段
启用 Netty 自带的泄露检测是最直接方式：
立即学习“Java免费学习笔记（深入）”；
- JVM 启动参数加入：-Dio.netty.leakDetection.level=PARANOID（开发/测试环境推荐）
- 运行时若发生未释放，控制台会打印详细堆栈，指出哪个
ByteBuf在哪行代码创建、谁没释放 - 注意：
PARANOID有性能开销，生产慎用；可降级为ADVANCED或SIMPLE平衡精度与开销 - 配合
ResourceLeakDetector.setLevel()动态调整级别，便于线上灰度验证
防御性编码建议
从写法上减少出错概率：
- 在 handler 中处理入参
ByteBuf时，采用try-finally包裹核心逻辑，finally 中统一 release - 避免裸传
ByteBuf给业务方法；封装成不可变视图（如buf.slice().readOnly()）或拷贝（buf.copy()），把所有权留在 handler 层 - 使用
SimpleChannelInboundHandler<ByteBuf>—— 它会在channelRead0()返回后自动 release 入参，前提是你不提前 fire 或 retain - 自定义工具类做
ByteBufUtil.getBytes()等操作时，确认是否消耗引用；必要时加注释说明调用方是否需负责释放
