BufferOverflowException 是 Java NIO 缓冲区状态管理失当的明确信号，源于写入前未校验 remaining() 而越界 put，需严格遵循 flip/clear/compact 状态流转并做两级长度校验。

BufferOverflowException 不是内存溢出，也不是安全漏洞，而是 Java NIO 缓冲区状态管理失当的明确信号。它在 put() 试图写入超出 limit - position（即 remaining()）时立即抛出，本质是设计上的边界保护，不是该靠 try-catch 捕获的运行时错误。

写入前必须检查 remaining()，别信 capacity()

capacity() 是总容量，真正决定“还能写多少”的是 remaining()。flip() 后 position 归零、limit 缩到已写长度，此时即使 capacity 很大，remaining() 也可能为 0。硬编码长度或只比对 data.length 和 capacity() 都会失效。

• 用 buffer.hasRemaining() 判断是否可写
• 用 buffer.remaining() >= data.length 做显式校验，再 put
• 对动态数据流，用 buffer.put(src, offset, length) 并确保 length ≤ remaining()

严格遵循缓冲区状态流转：写 → flip → 读 → clear/compact

异常大多源于状态错乱。比如 flip() 后没 clear 就再次 put，position 已等于 limit，remaining() 为 0，必然触发异常。

• 完成写入后，必须调用 flip() 才能安全读取
• 读完需重用缓冲区时：clear()（丢弃全部，重置为可写）或 compact()（保留未读数据，适合流式处理）
• 避免手动修改 position/limit —— 它们应由 flip/clear/compact 自动维护

对外部输入做两级长度校验

网络或文件场景中，不能把 read() 返回值或包头字段当“绝对可信”。攻击者可能伪造大 length 字段，诱使你分配不足空间或越界写入。

立即学习“Java免费学习笔记（深入）”；

• 先解析协议头获取 payload 长度 L
• 校验 L ≤ 缓冲区当前 remaining()，且 L ≤ 业务允许最大值（如 1MB）
• 仅当双校验通过，才执行后续 put 或分配新缓冲区

用只读视图或封装类加固不可信操作

对第三方数据源或沙箱环境，可提前切断非法写入路径。

• 用 buffer.asReadOnlyBuffer() 创建只读副本，任何 put() 立即抛 ReadOnlyBufferException（比 BufferOverflowException 更早拦截）
• 封装 SafeByteBuffer 工具类，在 put 前自动校验，统一收口边界逻辑
• 对超大数据，主动分片处理，不依赖单个 ByteBuffer 吞下全部