java nio自定义编解码器核心是绕过字符串、直接操作bytebuffer处理二进制报文，通过“长度域前置”协议（4字节大端总长+1字节命令+载荷）解决粘包半包，解码边读边判、编码零拷贝写入，并集成至selector的op_read回调中安全非阻塞运行。
Java NIO 中自定义编解码器处理二进制报文，核心是绕过字符串转换、直接操作字节，用 ByteBuffer 管理状态，并在非阻塞流程中安全应对粘包、半包和边界错位。不依赖 Netty 也能实现，关键是协议设计清晰、解析逻辑可恢复、内存操作不越界。
协议设计：必须定死字段长度与字节序
二进制协议不能靠“猜”，每个字段的类型、宽度、顺序、字节序都得白纸黑字约定好。常见可靠结构是“长度域前置”：
- 前 4 字节：消息总长度（含头部，固定用
ByteOrder.BIG_ENDIAN） - 第 5 字节：命令类型（
byte） - 后续字节：有效载荷（长度 = 总长 − 5）
这个结构让接收方能提前知道“还要等多少字节”，是判断一帧是否收全的唯一依据。如果设备端用小端写长度，Java 端却按大端读，10 就会变成 1677721600——这种低级错误在线上极难排查，务必在协议文档里加粗标出字节序。
解码器：边读边判，不等不丢
解码不是“攒够再 parse”，而是在每次 SocketChannel.read() 后立刻检查缓冲区能否构成完整帧。关键步骤如下：
- 检查当前
ByteBuffer.position() ≥ 4：不够 4 字节，说明连长度域都没收齐，直接返回，等下次 read - 调用
buffer.getInt(0)提取总长度（注意先buffer.order(ByteOrder.BIG_ENDIAN)） - 检查
totalLen ≤ buffer.limit()：不够整帧，继续等待；够了就用buffer.slice()截取子缓冲区解析 - 成功解析后，调用
buffer.position(totalLen)再buffer.compact()，把未读字节移到开头，为下一次 read 做准备 - 整个过程需放在
while循环里——一次 read 可能带多帧，也可能只带半帧
编码器：构造字节流，零拷贝写入
编码就是把业务对象转成严格对齐的字节数组。不建议用 String.getBytes() 或 DataOutputStream 包装，而是直接操作 ByteBuffer：
- 分配足够空间：比如
ByteBuffer.allocateDirect(totalLen)，避免堆内复制 - 先写长度域：
buffer.putInt(totalLen)（确保 order 正确） - 再写命令类型：
buffer.put(cmd) - 最后写 payload：
buffer.put(payload)，或用buffer.put(src, offset, length)精确控制 - 调用
buffer.flip()切换至读模式，交给SocketChannel.write(buffer)发送
全程不创建中间 byte[]，不触发 GC，符合 NIO 高性能初衷。
集成到 Selector：绑定事件，不阻塞主线程
解码逻辑必须嵌入 OP_READ 就绪回调中，且不能抛异常中断循环：
- 在
SelectionKey.isReadable()为 true 时，调用channel.read(buffer) - read 返回值 ≤ 0 时，说明连接关闭或暂无数据，跳过解析
- read > 0 后立即进入上述 while 解析循环，反复尝试提取完整帧
- 每帧解析后生成对应业务对象（如
MsgPacket），交由业务线程池处理，NIO 线程只管 IO 和解析
这样既保持非阻塞主干，又把协议语义从字节流中准确剥离出来。
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
