Java ByteBuffer mark 和 reset 怎样回到已标记位置
来源:17golang原创
时间:2026-11-11 07:20:10 487浏览 收藏
我第一次在 Java NIO 里给变长字段做“试读”时,最容易混淆的是:mark() 并没有复制一份字节,reset() 也不是把缓冲区内容恢复原样。它们操作的是同一个 ByteBuffer 的游标状态。直接记住一句话:mark() 记录当前 position,reset() 把 position 放回这个标记位置。
官方地址:https://docs.oracle.com/en/java/javase/26/docs/api/java.base/java/nio/ByteBuffer.html
如果只是想在解析判断失败后回到某个读取位置,优先用 mark/reset;如果需要多个互不影响的读取视角,再考虑 duplicate。reset 能否成功,关键在于 mark 是否仍然有效。
mark 保存的是 position,不是数据副本
ByteBuffer 至少要看三个状态:position 是下一次相对读写的位置,limit 是当前可访问上界,mark 是可选的回退位置。调用 mark() 时,mark 被设置为当下的 position;调用 reset() 时,position 回到 mark,mark 本身不会因为 reset 自动消失。
ByteBuffer buffer = ByteBuffer.wrap(new byte[] {10, 20, 30, 40});
// 先读取一个字节,再把当前位置记下来,便于后续回退。
buffer.get();
buffer.mark();
// 相对读取会推进 position,但不会改变已经记录的 mark。
buffer.get();
buffer.get();
// reset 只恢复游标位置,底层四个字节仍然保持原样。
buffer.reset();
byte value = buffer.get(); // 从 mark 对应的位置再次读取
这里的重点是“游标回退”,不是“内容回滚”。如果中间调用的是 put 并改写了底层字节,reset() 不会撤销这次写入;它只负责改变下一次相对读写从哪里开始。

在变长字段解析里用 mark 做一次回退
mark/reset 很适合“先看一眼,再决定是否消费”的局部解析。例如协议字段可能是短头部,也可能是扩展头部,先保存当前位置,读取足够的判断字节;如果发现这不是目标类型,就回到标记处交给另一个分支处理。
ByteBuffer input = ByteBuffer.wrap(new byte[] {0x2A, 0x01, 0x7F});
// 保存候选字段的起点;后续失败时仍从这里交给其他解析分支。
input.mark();
byte kind = input.get();
if (kind != 0x10) {
// 不匹配时只回退 position,不复制也不清空缓冲区内容。
input.reset();
}
// 当前分支只在确认类型后继续消费剩余字节。
if (input.hasRemaining()) {
byte first = input.get();
}
这种写法的边界是:mark 只属于当前 buffer 实例,而且只保存一个位置。再次调用 mark() 会覆盖旧标记。如果业务需要同时保存多个候选起点,单个 mark 不够,应显式保存 int position = input.position(),或者用多个 duplicate() 创建独立游标。
为什么 reset 有时会抛 InvalidMarkException
最直接的原因是当前 buffer 没有有效 mark:从未调用 mark(),或者标记已经被状态操作丢弃。官方 API 还明确说明,调用 position(newPosition) 时,如果新位置小于 mark,mark 会被丢弃;设置更小的 limit 也可能让 mark 失效。
另外几个常见操作也要特别小心:
| 操作 | 对 mark 的影响 | 排查重点 |
|---|---|---|
position(newPosition) | 新位置落在 mark 之前时丢弃 | 不要把它当作无条件回退 |
limit(newLimit) | 新上限落在 mark 之前时丢弃 | 缩小读取窗口后重新 mark |
clear/flip/rewind/compact | 会丢弃 mark | 这些是改变缓冲区工作状态的操作 |
reset() | 没有有效 mark 时抛 InvalidMarkException | 确认 mark 与 reset 属于同一个实例 |
ByteBuffer buffer = ByteBuffer.allocate(8);
// 这里先建立标记,reset 才有可恢复的位置。
buffer.position(4);
buffer.mark();
// 把 position 移到 mark 之前会让标记失效。
buffer.position(2);
try {
// 标记已失效,不能把 reset 当成历史快照恢复。
buffer.reset();
} catch (InvalidMarkException ex) {
// 生产代码应转入重新定位或放弃当前解析分支。
System.out.println("mark 已失效,需要重新定位");
}

我的取舍:短回退用 mark,多视角用 duplicate
对我来说,mark/reset 的优点是意图非常直白:在一段局部判断前打标记,失败后回到原点。它的代价也同样明确:只有一个 mark,并且依赖 buffer 的状态操作没有把标记清掉。只要代码中同时出现 clear、flip、compact 或跨层传递 buffer,就应把 mark 的生命周期写在注释里。
如果两个解析分支需要同时保留各自的 position、limit 和 mark,duplicate() 更合适。它们共享底层内容,但游标状态独立;这解决的是“多个读取视角”,不是 mark/reset 的回退问题。不要为了回退而复制整个字节数组,也不要把 reset 误当成事务回滚。
最后可以按这张清单判断:
- 只需要一个短暂回退点:用
mark()和reset()。 - 需要多个独立读取游标:用
duplicate()或显式保存 position。 - 需要撤销写入内容:mark/reset 不适用,应设计自己的数据副本或事务层。
相关问题
reset 会把 limit 一起恢复吗?
不会。reset 只把 position 恢复到 mark,limit、capacity 和底层内容都不会因此回到过去的状态。
mark 能不能跨 duplicate 使用?
不能把它理解成跨实例共享的标记。duplicate 共享内容,但每个 buffer 的 position、limit、mark 独立;应在实际要 reset 的那个实例上建立 mark。
-
131 收藏
-
329 收藏
-
479 收藏
-
337 收藏
-
128 收藏
-
142 收藏
-
339 收藏
-
238 收藏
-
112 收藏
-
477 收藏
-
文章 · java教程 | 17分钟前 | 异步任务 · CompletableFuture · java 异步编程 错误恢复 completablefuture Complete obtrudeValue470 收藏
-
文章 · java教程 | 20分钟前 | 异步编程 · CompletableFuture · java completablefuture 异步异常 exceptionallyCompose CompletionStage 备用任务329 收藏
-
488 收藏
-
479 收藏
-
297 收藏
-
363 收藏
-
123 收藏
-
- 前端进阶之JavaScript设计模式
- 设计模式是开发人员在软件开发过程中面临一般问题时的解决方案,代表了最佳的实践。本课程的主打内容包括JS常见设计模式以及具体应用场景,打造一站式知识长龙服务,适合有JS基础的同学学习。
- 立即学习 543次学习
-
- GO语言核心编程课程
- 本课程采用真实案例,全面具体可落地,从理论到实践,一步一步将GO核心编程技术、编程思想、底层实现融会贯通,使学习者贴近时代脉搏,做IT互联网时代的弄潮儿。
- 立即学习 516次学习
-
- 简单聊聊mysql8与网络通信
- 如有问题加微信:Le-studyg;在课程中,我们将首先介绍MySQL8的新特性,包括性能优化、安全增强、新数据类型等,帮助学生快速熟悉MySQL8的最新功能。接着,我们将深入解析MySQL的网络通信机制,包括协议、连接管理、数据传输等,让
- 立即学习 500次学习
-
- JavaScript正则表达式基础与实战
- 在任何一门编程语言中,正则表达式,都是一项重要的知识,它提供了高效的字符串匹配与捕获机制,可以极大的简化程序设计。
- 立即学习 487次学习
-
- 从零制作响应式网站—Grid布局
- 本系列教程将展示从零制作一个假想的网络科技公司官网,分为导航,轮播,关于我们,成功案例,服务流程,团队介绍,数据部分,公司动态,底部信息等内容区块。网站整体采用CSSGrid布局,支持响应式,有流畅过渡和展现动画。
- 立即学习 485次学习