java nio常见坑有哪些

Java NIO（New I/O，即 java.nio 包，尤其是基于 Channel/Buffer/Selector 的网络编程）功能强大，但“坑”也非常多。下面按常见程度 + 实战踩坑点给你系统梳理一下。

一、Buffer 相关坑

1. flip() / clear() / compact() 用错

这是最容易出 bug 的地方。

• 写数据后没 flip() 就读 → 读不到数据
• 读完没 clear() / compact() → 下一次写覆盖或读不到

buffer.put("hello".getBytes());
// 忘记 flip
channel.read(buffer); // 出错

✅ 建议：

• 写 → 读：flip()
• 读 → 写：clear() 或 compact()
• 封装读写逻辑，避免手动乱调

2. Buffer 位置状态难以 debug

position / limit / capacity 三者容易混淆，出错时没有任何异常，只是“没数据”。

✅ 建议：

• 出错时打印：

buffer.position(), buffer.limit(), buffer.capacity()

• 或直接使用 ByteBuffer.wrap() 简单场景

3. DirectByteBuffer 内存泄漏

ByteBuffer.allocateDirect() 不在 JVM 堆里：

• 不受 GC 直接管理
• 不关 / 用太多 → 直接 OOM（非堆）

✅ 建议：

• 只在高频 IO使用
• 控制数量，避免长期持有
• 必要时手动 System.gc()（不推荐，仅调试）

二、Selector 相关坑（最复杂）

4. Selector 空轮询（CPU 100%）

JDK 曾存在 epoll 空转 bug（Linux）：

while (selector.select() == 0) {}

✅ 解决方案：

• 使用 Netty（已解决）
• 或 JDK ≥ 1.8u192
• 加兜底：

if (selectedKeys == 0) {
    // 计数 + 重开 selector
}

5. OP_WRITE 滥用导致死循环

很多人一写不了就注册 OP_WRITE：

if (!buffer.hasRemaining()) {
    key.interestOps(SelectionKey.OP_WRITE);
}

但：

• 写缓冲区可写时会一直触发
• 不取消 → CPU 飙升

✅ 正确做法：

• 仅在写半包时注册
• 写完立刻取消：

key.interestOps(SelectionKey.OP_READ);

6. SelectionKey 忘记取消

• Channel 关闭但 key 没 cancel
• 导致 selector 一直监听已死连接

✅ 建议：

key.cancel();
channel.close();

7. 一个 Selector 处理太多连接

• 单线程 selector
• 某个 channel 处理慢 → 阻塞其他所有连接

✅ 建议：

• 业务处理和 IO 分离
• 或使用 Reactor 多线程模型

三、Channel 相关坑

8. SocketChannel 是非阻塞的，但“看起来像同步”

socketChannel.read(buffer);

• 可能返回 0
• 可能返回 -1（断开）
• 可能只读了半包

✅ 必须自己处理：

• 半包
• 拆包
• 粘包

9. 半包 / 粘包问题

NIO 不保证消息边界。

❌ 错误：

read() 一次 = 一条消息

✅ 解决：

• 定长
• 分隔符
• 长度字段（最常见）

10. 忘记设置 TCP_NODELAY

socketChannel.setOption(StandardSocketOptions.TCP_NODELAY, true);

否则：

• 小包被合并
• 延迟高（Nagle 算法）

四、多线程 & 并发坑

11. Buffer 非线程安全

ByteBuffer 不是线程安全的。

❌ 多线程共享一个 buffer ✅ 每线程一个 / 使用 ThreadLocal

12. 在 IO 线程做重业务

key.interestOps(OP_READ);
doHeavyBusiness(); // 阻塞

✅ 正确：

• IO 线程只做 IO
• 业务丢线程池

五、资源 & 异常坑

13. 忘记关闭 Channel / Selector

• 文件描述符泄漏
• Too many open files

✅ 用 try-with-resources：

try (SocketChannel ch = SocketChannel.open()) {}

14. IOException: Connection reset

• 对方强制断开
• 没处理 -1 和异常

✅ 必须：

if (n == -1) close();

六、为什么大多数人“最后都用 Netty”

✅ 结论：

生产环境：用 Netty
学习原理：写原生 NIO

总结一句话

Java NIO 的坑，90% 都在 Buffer 状态 + Selector 事件 + 半包处理 上。

如果你愿意，我可以：

• 给你一个典型 NIO 服务端示例（含坑注释）
• 或对比 NIO vs Netty 代码差异
• 或专门讲 Netty 是怎么避开这些坑的

你想看哪个？