Go / 系统课时
用 nc 验证 TCP 协议
用 nc 验证 TCP 协议
写完 TCP 服务后,最先要确认的不是业务逻辑,而是服务到底收到什么字节、何时返回、对端关闭后如何退出。本节用 nc 作为最小客户端,验证行协议、EOF 与“TCP 只有字节流,没有消息边界”这三个关键行为。
学习目标
- 用
nc建立 TCP 连接并发送可控字节 - 用换行符验证应用层消息边界,避免把一次
Read当成一条消息 - 观察客户端关闭写方向后,服务端如何读到 EOF 并释放连接
准备一个可观察的 TCP 服务
先准备一个最小 Echo 服务。它故意用换行符作为应用层消息边界,并把每行的字节数写回客户端。这样既能验证收发内容,也能看到连接关闭后的 EOF。
package main
import (
"bufio"
"errors"
"fmt"
"io"
"log"
"net"
)
func handleConn(conn net.Conn) {
defer conn.Close()
reader := bufio.NewReader(conn)
for {
// 换行符是应用层协议边界,不是 TCP 自带的消息边界。
line, err := reader.ReadString('\n')
if len(line) > 0 {
if _, writeErr := fmt.Fprintf(conn, "ACK %d %s", len(line), line); writeErr != nil {
return
}
}
if err != nil {
if errors.Is(err, io.EOF) {
fmt.Println("peer closed write side")
return
}
log.Printf("read error: %v", err)
return
}
}
}
func main() {
ln, err := net.Listen("tcp", "127.0.0.1:9000")
if err != nil {
log.Fatal(err)
}
defer ln.Close()
fmt.Println("listening on 127.0.0.1:9000")
for {
conn, err := ln.Accept()
if err != nil {
log.Fatal(err)
}
go handleConn(conn)
}
}运行服务:
go run main.go预期结果(服务继续保持运行):
listening on 127.0.0.1:9000用 nc 发送完整的协议帧
以下命令按两行发送 PING 和 HELLO。示例使用支持 -N 的 OpenBSD netcat:标准输入到 EOF 后,它会关闭 TCP 的写方向。若本机 nc -h 不支持该选项,应按当前实现的帮助使用等价的“stdin EOF 后关闭 socket”能力。
printf 'PING\nHELLO\n' | nc -N 127.0.0.1 9000预期输出:
ACK 5 PING
ACK 6 HELLO服务端随后还会打印:
peer closed write side这里的 5 和 6 包含每行末尾的换行字节。这个结果同时证明了客户端发送的协议分隔符已被服务端读取,而不是只证明“端口能连通”。
区分协议边界和 TCP 读取边界
TCP 提供的是有序字节流,不保留发送端一次 write 或一次命令调用的边界。上面的服务之所以能得到两条消息,是因为代码主动使用 \n 作为分隔符,并用 ReadString('\n') 持续累积字节。
因此,不能把“某次 Read 返回了 128 字节”理解为“收到了一条 128 字节消息”。一条应用消息可能被拆成多次读取,多条消息也可能在一次读取中一起到达。真实协议必须自己定义边界,例如换行分隔、固定长度或“长度字段 + 负载”。
看懂 EOF 和连接关闭
nc -N 在标准输入结束后关闭写方向,服务端把此前已经到达的字节读完后,下一次读取会得到 io.EOF。EOF 表示“对端不会再从这个方向发送更多字节”,它本身不是协议错误。
如果连接被异常复位,服务端可能得到的不是 EOF,而是其他网络错误。生产代码应区分正常结束、超时和异常断开,并保证无论哪种路径都能让处理 goroutine 返回并关闭连接。
用 nc 排查时优先确认什么
先看是否能建立连接,再看服务收到的分隔符和字节内容是否符合协议,最后观察客户端结束后服务端是否及时退出处理函数。若双方都一直等待,常见原因不是 TCP “卡住”,而是协议一端在等分隔符,另一端又在等响应或 EOF。