java nio常见错误有哪些

Java NIO（New I/O，主要包括 java.nio 包及其子包，以及 Selector、Channel、Buffer、Charset 等）虽然性能高、可扩展好，但 API 相对底层，很容易踩坑。下面按常见错误类型整理，并给出原因和正确做法。

一、Buffer 使用错误（最常见）

1. 忘记 flip()

buffer.put("hello".getBytes());
channel.write(buffer); // 可能写不出去

原因：put 后 position 在末尾，write 从 position 读，什么都读不到。

✅ 正确：

buffer.put(data);
buffer.flip();
channel.write(buffer);

2. 忘记 clear() / compact()

读取一次后再次使用 Buffer 时数据混乱。

• clear()：清空，准备写入
• compact()：保留未读数据，准备继续写

✅ 读后写：

buffer.compact();

3. 误用 remaining()

while (buffer.hasRemaining()) {
    // 容易死循环，如果没 flip 或没读干净
}

确保：

• flip() 后再读
• 读操作真正消费了数据

二、Channel 使用错误

4. 对非阻塞 Channel 做阻塞假设

int n = channel.read(buffer); // n 可能为 0

在非阻塞模式下：

• n == 0 是正常的
• n == -1 表示连接关闭

✅ 正确循环读取：

while (channel.read(buffer) > 0) {
    ...
}

5. 忘记关闭 Channel / 资源泄漏

SocketChannel channel = SocketChannel.open();
// 忘记 close()

✅ 使用 try-with-resources：

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

三、Selector 使用错误

6. 忘记 selectionKey.interestOps() 更新

写完数据后不取消 OP_WRITE，导致 CPU 空转。

✅ 写完关闭写事件：

key.interestOps(SelectionKey.OP_READ);

7. 在 select() 后不处理 selectedKeys

selector.select();
// 没遍历 selectedKeys

✅ 必须遍历并移除：

Iterator<SelectionKey> it = selector.selectedKeys().iterator();
while (it.hasNext()) {
    it.remove();
}

8. 错误理解 select() 阻塞

• select() 可能返回 0（超时）
• 不是“有事件才返回”

四、网络 & 线程模型错误

9. 在 Selector 线程中做耗时操作

if (key.isReadable()) {
    Thread.sleep(1000); // 错误
}

✅ 把业务处理丢到线程池。

10. 多线程操作同一个 Channel

• NIO Channel 不是线程安全的
• 一个 Channel 最好由一个线程管理

五、字符 & 编码错误

11. 直接使用 String.getBytes()

buffer.put("中文".getBytes()); // 平台依赖

✅ 明确编码：

buffer.put("中文".getBytes(StandardCharsets.UTF_8));

12. 忘记 CharsetDecoder/Encoder

跨平台通信建议显式编解码。

六、其他常见坑

13. ByteBuffer 容量固定

不能直接扩容，需要手动创建新 Buffer 并拷贝。

14. 使用 allocate 而非 allocateDirect 的误判

• DirectBuffer：少一次拷贝，但创建成本高
• 并非“越多越好”

15. TCP 拆包 / 粘包未处理

NIO 是流式协议，必须自己定义：

• 长度字段
• 分隔符
• 协议头

总结速查表

如果你愿意，我可以：

• 给你一个最小可运行的 NIO 示例（含正确写法）
• 或针对 Netty vs 原生 NIO 做对比
• 或帮你 排查你现在的 NIO 报错代码

你可以直接贴代码。