ByteBuffer flip 状态怎么配置或排查

ByteBuffer.flip() 不是“把字节反转”，而是切换缓冲区的读写边界：它先把当前 position 设为 limit，再把 position 归零，同时丢弃 mark。也就是说，put 或 Channel.read 写入了多少字节，flip() 就让接下来的相对读取只能看到这段范围。

先看三个状态值，判断现在到底能读还是能写

ByteBuffer 的容量由 capacity 固定，position 指向下一次相对读写的位置，limit 指向本轮允许访问的上界（不包含该位置）。新建缓冲区通常是 position=0、limit=capacity，因此适合先写入；读取前必须把有效数据的终点交给 limit。

最常见的误判是：缓冲区里确实写进过字节，但仍处在写入态，读取时 limit 还是容量，或者已经读完后 position 等于 limit。下面这个小方法适合临时放在日志附近，不改变缓冲区状态。

static String bufferState(String label, ByteBuffer buffer) {
    // 同时打印三条边界，避免把 position 误认为有效数据长度。
    return "%s position=%d limit=%d capacity=%d remaining=%d"
            .formatted(label, buffer.position(), buffer.limit(),
                    buffer.capacity(), buffer.remaining());
}

put 或 Channel.read 之后，flip 如何把写入区交给读取区

假设容量是 8，向缓冲区放入 3 个字节后，状态是 position=3、limit=8。这时直接相对 get() 并不能表达“只读刚刚写入的 3 个字节”；调用 flip() 后才变成 position=0、limit=3，remaining() 也会准确返回 3。

这条边界可以理解为“生产游标”交给“消费游标”：put 或读取通道负责推进写入位置，flip 固定有效数据上界，get 或写出通道再从零开始消费。

ByteBuffer buffer = ByteBuffer.allocate(8);
buffer.put((byte) 0x41).put((byte) 0x42).put((byte) 0x43);
// 写入结束后固定有效范围，再从零开始读取。
buffer.flip();
while (buffer.hasRemaining()) {
    // 相对 get 会推进 position，直到 limit 而不是 capacity。
    byte value = buffer.get();
    System.out.println((char) value);
}

如果这里漏掉 flip()，缓冲区仍认为自己在写入阶段，读取结果可能包含未写入区域的默认值；如果先调用了两次 flip()，第二次会把当前的 0 再次变成 limit，读区就为空。排查时重点找“最后一次写入”和“第一次读取”之间是否恰好只有一次状态切换。

clear、rewind、compact 不要用错，尤其注意半包

clear() 不会擦除底层字节，只是把边界恢复成可重新填充的状态；因此它适合处理完本轮数据后复用缓冲区。rewind() 适合在 limit 已经正确的前提下从头再读一遍，例如重复计算校验值。

网络协议或文件分块读取更容易踩到 compact()：本轮已经读完的前缀可以丢弃，尚未读完的尾部必须保留。compact 会把这段剩余数据搬到开头，然后把 position 放到剩余数据之后、limit 恢复为 capacity，下一次通道读取可以接着追加。

buffer.flip();
while (buffer.hasRemaining()) {
    // 这里只消费当前已经收到的字节，未完整的消息会留下尾部。
    decodeAvailable(buffer);
}
// 保留未消费的半包，并恢复可写上界，等待下一次读取补齐。
buffer.compact();

如果每轮读取前都调用 clear()，半包会被当成废数据；如果每轮读取后都调用 rewind()，已经消费的内容会被重复处理。方法名不是配置项，真正要匹配的是“旧数据是否还有效”这个业务事实。

用一张排查清单定位读不到数据和下溢异常

先记录状态，再沿着一次完整的读写边界检查，不要靠扩大容量掩盖问题。

1. 确认写入返回值或 put 次数，记下写入结束时的 position。
2. 确认读取前是否调用一次 flip()，并检查 flip 后的 limit 是否等于预期字节数。
3. 相对读取前判断 remaining()，需要固定长度时先判断是否足够，再调用 get。
4. 多轮通道读写中，若存在半包，使用 compact() 保留尾部；完整处理后才用 clear() 重新填充。

BufferUnderflowException 往往说明读取量超过了当前 limit，而不是 capacity 太小；BufferOverflowException 则通常表示写入量超过了当前 limit。把异常发生前的 position、limit、remaining 一起记下来，通常比单独贴异常类名更快找到错位的那一次状态切换。

常见问题与边界

flip 会不会清空 ByteBuffer？

不会。它只重设 position、limit 并丢弃 mark，底层字节仍在；只是读取范围改成从 0 到旧 position。

为什么读取前 limit 不是 capacity？

因为 flip 把本轮实际写入的终点设成 limit。读取逻辑应以 limit 为边界，capacity 只表示底层空间总量。

什么时候该用 compact 而不是 clear？

当当前缓冲区仍有未消费的有效尾部时用 compact；如果本轮数据已全部消费、下一轮可以从空缓冲区开始，才用 clear。

收尾判断

记住一条最实用的顺序：写入完成后 flip()，读取完成后根据尾部是否有效选择 clear() 或 compact()，需要重复消费同一段数据时才用 rewind()。一旦出现空读或下溢，先看状态三元组，再检查状态切换次数。