BufferUnderflowException 是因 position ≥ limit 时仍调用 get() 等读取方法所致，主因是未检查 hasRemaining()、重复 flip() 或手动误改 position/limit；应遵循“先检查再读取”原则，用 hasRemaining() 和 flip() 确保状态正确。
BufferUnderflowException 是 Java NIO 中一个常见的运行时异常，发生在从 Buffer（如 ByteBuffer、CharBuffer 等）中读取数据时，当前 position 已经到达或超过 limit，但程序仍尝试获取下一个元素。
为什么会抛出 BufferUnderflowException
根本原因是缓冲区已“空”，却还继续读取。Java NIO 的 buffer 有三个关键属性：position（当前读写位置）、limit（读写边界）、capacity（总容量）。当 position >= limit 时，再调用 get()、getChar()、getInt() 等读取方法，就会触发该异常。
常见诱因包括：
- 未检查
hasRemaining()就直接读取 - 多次
flip()后误以为还有数据可读（flip()会把 limit 设为当前 position，position 归零；重复 flip 会导致 limit ≤ position） - 手动修改了 position 或 limit，破坏了 buffer 状态一致性
- 读取字节后未及时判断是否越界，例如循环中硬编码读取固定次数
如何安全地读取 buffer 数据
核心原则是：**先检查，再读取**。推荐使用标准流程，避免依赖 position/limit 的手动计算。
Java Maven Common
下载
Java Maven 项目审查工作流的通用输入处理。当 Java Maven 项目以 ZIP压缩包或 GitLab 仓库 URL 形式提供且需要...时使用。
立即学习“Java免费学习笔记（深入）”；
- 读取前调用
buffer.hasRemaining()判断是否还有数据可读 - 用
while (buffer.hasRemaining()) { ... buffer.get() ... }替代 for 循环硬计数 - 批量读取时，用
buffer.get(byteArray, offset, length)并确保 length ≤buffer.remaining() - 必要时用
buffer.mark()和buffer.reset()控制读取点，但需配合buffer.rewind()或buffer.flip()正确重置状态
调试和定位技巧
遇到此异常时，不要只看堆栈，重点检查 buffer 的实时状态：
- 打印
buffer.position()、buffer.limit()、buffer.capacity()和buffer.remaining() - 确认上一次
flip()或compact()是否被正确调用——特别是网络 I/O 中，一次接收后忘记 flip 就直接读，常导致 position=0、limit=0 - 注意多线程场景：多个线程共享同一 buffer 且未同步操作，可能造成状态错乱
- 使用
ByteBuffer.asReadOnlyBuffer()防止意外写入干扰读取逻辑
一个典型错误示例与修正
错误写法：
ByteBuffer buf = ByteBuffer.allocate(4);buf.putInt(123);
// 忘记 flip，position=4, limit=4
int value = buf.getInt(); // 抛出 BufferUnderflowException
正确写法：
ByteBuffer buf = ByteBuffer.allocate(4);buf.putInt(123);
buf.flip(); // position=0, limit=4
int value = buf.getInt(); // 成功读取
