Java 后端 / 系统课时
理解 TCP 粘包拆包问题
理解 TCP 粘包拆包问题
本节解决 TCP 数据读取边界不明确的问题,理解为什么一次发送的数据可能被多次读取或多次发送的数据被一次读取,并掌握 Netty 中处理消息边界的常用方案。
学习目标
- 理解 TCP 字节流模型与消息边界之间的差异
- 掌握长度字段、固定长度和分隔符等拆包方案
- 能够分析 TCP 粘包拆包导致的业务异常
TCP 为什么会出现粘包和拆包
TCP 提供的是可靠的字节流传输,而不是带消息边界的消息协议。发送端调用一次写操作,并不代表接收端一定会对应一次读取操作。
例如客户端连续发送两个业务消息:HELLO 和 WORLD,接收端可能读取到 HELLOWORLD,也可能先读取 HEL,再读取剩余内容。这是 TCP 缓冲区、网络传输和操作系统调度共同决定的结果。

常见拆包方案
解决 TCP 消息边界问题,需要在应用协议层增加规则。常见方案包括固定长度、分隔符和长度字段。
固定长度协议适合消息大小始终一致的场景,例如每个数据包固定占用 128 字节。分隔符协议适合文本协议,例如使用换行符表示消息结束。
长度字段协议是生产系统最常见的方式,由发送方先写入消息长度,接收方读取长度后再读取对应数量的数据。
使用长度字段定义消息协议
下面示例展示一个简单协议:前 4 字节表示消息长度,后续内容表示消息正文。
java
import java.nio.ByteBuffer;
import java.nio.charset.StandardCharsets;
public class LengthProtocolDemo {
public static void main(String[] args) {
String message = "hello netty";
byte[] body = message.getBytes(StandardCharsets.UTF_8);
// 协议格式:长度字段 + 消息内容
ByteBuffer buffer = ByteBuffer.allocate(4 + body.length);
buffer.putInt(body.length);
buffer.put(body);
buffer.flip();
int length = buffer.getInt();
byte[] result = new byte[length];
buffer.get(result);
System.out.println(new String(result, StandardCharsets.UTF_8));
}
}预期输出
text
hello netty实际项目中,Netty 提供了多种 Frame Decoder,可以根据协议规则自动完成边界判断,避免业务代码手动处理 ByteBuffer。
排查粘包拆包异常
遇到消息内容错乱、字段拼接、JSON 解析失败等问题时,首先确认协议是否定义消息边界。
常见排查顺序如下:
- 检查发送端是否存在连续写入多个消息的情况。
- 检查接收端是否假设一次读取就是完整消息。
- 检查协议是否包含长度字段或结束标记。
- 使用网络抓包确认实际传输的数据流。
TCP 粘包拆包不是网络异常,而是字节流协议与业务消息模型之间的差异。稳定的网络服务必须在应用层明确消息边界。
按自己的节奏,确认真正理解。