Java解析自定义二进制协议需直面字节、主动状态管理，采用“固定头（4字节长度+1字节指令）+变长体”结构，用ByteBuffer.allocateDirect配合compact、边读边判、循环拆帧，并注意字节序、无符号byte处理及安全数据提取。
先定协议结构：长度域前置最稳妥
推荐采用“固定头 + 变长体”设计，例如：
- 前 4 字节：消息总长度（含头部，网络字节序，即大端）
- 第 5 字节：指令类型（byte，如 0x01 登录、0x99 心跳）
- 后续字节：payload（长度 = 总长 − 5）
这种结构让解析器能主动判断一帧是否收全，避免依赖 TCP 的“自然分包”，是 NIO 场景下最易实现、最抗粘包的设计。
用 ByteBuffer 做接收缓冲：compact 而非 clear
SocketChannel.read() 不保证一次读完一帧，必须自己缓存未消费字节：
- 分配一个可扩容的直接缓冲区：ByteBuffer.allocateDirect(8192)
- 每次 read() 后检查 buffer.position() > 0，才进入解析循环
- 解析成功一帧后，调用 buffer.compact() —— 把未读字节移到开头，保留 position 和 limit 关系
- 切忌用 clear()，它会重置 position=0、limit=capacity，导致未读数据被覆盖
解析逻辑：边读边判，循环拆帧
不是“攒够再 parse”，而是“每来一点就试能否成帧”。典型步骤如下：
Alibabacloud Sdk Client Initialization For Java
下载
在 Java 中初始化和管理阿里云 SDK客户端。包括单例模式、线程安全、endpoint 与 region 配置、VPC 终端节点、同步与异步等。
立即学习“Java免费学习笔记（深入）”；
- 检查 buffer.remaining() ≥ 4：不够 → 等下次 read
- 用 buffer.getInt(0) 读取长度（注意先设 buffer.order(ByteOrder.BIG_ENDIAN)）
- 检查 totalLen ≤ buffer.capacity() 且 totalLen ≤ buffer.remaining()：不够 → 等下次
- 够了 → buffer.slice().limit(totalLen).position(0) 提取完整帧，再解析指令和 payload
- 从原 buffer 移除已解析部分：buffer.position(buffer.position() + totalLen)，再 compact
- 用 while 循环包裹整个流程，因一次 read 可能带多帧或半帧+整帧
处理 byte 指令：& 0xFF 归一化再 switch
Java 的 byte 是有符号的，0xFF 会被读作 −1，直接 switch 会匹配失败：
- 正确写法：switch (b & 0xFF)，把 byte 安全转为无符号 int
- case 0x01：登录 → 解析后续“N段长度”字段，再读对应长度内容
- case 0x99：心跳 → 单字节即完整，不读后续，但要检查是否粘包（后面还有字节？需重新同步）
- case 0xFF：内置通知 → 校验 tokenID 或服务标识位，按需响应
- default：记录日志并丢弃整帧，防止误解析污染状态
注意字节序与数据提取安全
别假设对方和你用同一套字节序，也别图省事碰 array()：
- 设置字节序必须在 getInt() / getShort() 之前：buffer.order(ByteOrder.LITTLE_ENDIAN)
- 禁止用 buffer.array()：它返回底层数组全量引用，无视 position/limit，极易越界或读脏数据
- 安全提取方式：byte[] data = new byte[buffer.remaining()]; buffer.get(data);
- 混合字节序字段（如头大端、payload 小端）不能靠 order() 切换解决，需手动拆字节拼接
