ByteBuffer.compact()的核心作用是在读取未完成时安全切换回写模式:将position到limit间的未读数据复制到缓冲区开头,position设为复制字节数,limit恢复为capacity,从而保留残留数据并腾出尾部空间接收新数据。

ByteBuffer.compact() 的精妙之处,不在于移动数据本身,而在于它用极简的指针操作,精准解决半包场景下“残留数据不能丢、新数据还要来”的矛盾。
compact() 是为“读一半就写”量身定制的模式切换
网络 I/O 中,一次 read() 常常只收到消息的一部分(比如协议头已解析,但 body 还没收全)。此时缓冲区处于“读模式中间态”:position 指向已读位置,limit 仍停在原始写入边界,中间那段未读数据(position 到 limit)必须保留。
- flip() 会把 limit 设为 position,导致未读部分被逻辑截断,下次再也读不到;
- clear() 会重置所有指针,未读数据虽物理存在,但已被划出有效范围,等于丢弃;
- compact() 则把 position 到 limit 这段字节,原样复制到缓冲区开头,然后让 position 指向复制结束处,limit 恢复为 capacity —— 数据没丢,尾部腾空,立刻可写。
指针状态变化体现设计意图
假设容量 1024 的 buffer,已写入 800 字节(position=800, limit=1024),你读了前 500 字节(position=500, limit=1024),剩下 300 字节待处理:
- compact() 执行后:下标 500~799 的 300 字节被拷贝到 0~299;
- position 被设为 300(即新数据将从索引 300 开始写);
- limit 恢复为 1024(表示还能写入最多 724 字节);
- mark 被丢弃——因为 compact 的目标是写,不是回溯读。
它不是“读完再收拾”,而是“边读边准备下一轮写”
compact() 的语义非常明确:为下一次 write() 或 read() 做准备,且前提是“还有未读数据要接着处理”。它常见于 TCP 半包循环中:
- 每次 channel.write(buffer) 返回值小于 buffer.remaining(),说明发送未完成 → 紧跟 compact(),保留未发完的数据;
- 若已完整读完一条消息,再调 compact() 就是多余拷贝,纯耗 CPU;
- 想立刻读刚 compact() 过来的那 300 字节?得再 flip() 一次,把 limit 设为 300、position 设为 0,才能 get()。
实际使用中容易忽略的关键细节
compact() 看似简单,但几个细节决定是否真正生效:
- 它只在读模式中间态调用才有意义;写模式下调用无效果,读完再调也浪费;
- 大缓冲区(如 64KB+)频繁 compact() 会触发大量内存拷贝,增加 GC 压力;
- HeapByteBuffer 拷贝走的是 JVM 堆,DirectByteBuffer 拷贝走的是堆外内存,性能差异明显;
- 它不改变 capacity,也不清空 mark,一切只为“保底续写”服务。

















