Go / 系统课时

用 nc 验证 TCP 协议

用 nc 验证 TCP 协议

写完 TCP 服务后,最先要确认的不是业务逻辑,而是服务到底收到什么字节、何时返回、对端关闭后如何退出。本节用 nc 作为最小客户端,验证行协议、EOF 与“TCP 只有字节流,没有消息边界”这三个关键行为。

学习目标

  • 用 nc 建立 TCP 连接并发送可控字节
  • 用换行符验证应用层消息边界,避免把一次 Read 当成一条消息
  • 观察客户端关闭写方向后,服务端如何读到 EOF 并释放连接

准备一个可观察的 TCP 服务

先准备一个最小 Echo 服务。它故意用换行符作为应用层消息边界,并把每行的字节数写回客户端。这样既能验证收发内容,也能看到连接关闭后的 EOF。

go
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)
    }
}

运行服务:

bash
go run main.go

预期结果(服务继续保持运行):

text
listening on 127.0.0.1:9000

用 nc 发送完整的协议帧

以下命令按两行发送 PING 和 HELLO。示例使用支持 -N 的 OpenBSD netcat:标准输入到 EOF 后,它会关闭 TCP 的写方向。若本机 nc -h 不支持该选项,应按当前实现的帮助使用等价的“stdin EOF 后关闭 socket”能力。

bash
printf 'PING\nHELLO\n' | nc -N 127.0.0.1 9000

预期输出:

text
ACK 5 PING
ACK 6 HELLO

服务端随后还会打印:

text
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。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

用 nc 验证 TCP 协议

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通