Go / 系统课时

用 TCP 跑通首个客户端

用 TCP 跑通首个客户端

这一节用一个可直接运行的 Go 程序完成一次 TCP 往返:客户端建立连接、发送字节、读取响应并关闭连接。程序内置最小测试服务端,因此不依赖前置课时,也能观察连接从创建到释放的完整路径。

学习目标

  • 使用 net.Dial 建立 TCP 连接,并识别连接成功与失败。
  • 使用 Write 与读取操作完成一次请求响应。
  • 理解 TCP 是字节流,连接关闭与消息边界需要由应用主动处理。

从一次往返理解客户端职责

TCP 客户端拿到的核心对象是 net.Conn。Dial 成功后,连接会持续存在,客户端可以在同一连接上多次读写,直到任一端关闭或网络出现错误。一次最小往返通常经历建立连接、发送字节、等待响应、关闭连接四个阶段。

TCP 客户端一次往返的生命周期

跑通最小 TCP 客户端

下面的程序先在本机启动一个只处理一次请求的测试服务端,再由客户端连接它。测试端只负责让示例自包含;真正需要关注的是客户端的 net.Dial、Write、io.ReadFull 和 Close。

go
package main

import (
    "fmt"
    "io"
    "net"
)

func main() {
    ln, err := net.Listen("tcp", "127.0.0.1:0")
    if err != nil {
        panic(err)
    }
    defer ln.Close()

    serverDone := make(chan error, 1)
    go func() {
        conn, err := ln.Accept()
        if err != nil {
            serverDone <- err
            return
        }
        defer conn.Close()

        buf := make([]byte, 4)
        if _, err := io.ReadFull(conn, buf); err != nil {
            serverDone <- err
            return
        }
        fmt.Printf("server received: %s\n", buf)

        _, err = conn.Write([]byte("pong"))
        serverDone <- err
    }()

    conn, err := net.Dial("tcp", ln.Addr().String())
    if err != nil {
        panic(err)
    }
    defer conn.Close()

    if _, err := conn.Write([]byte("ping")); err != nil {
        panic(err)
    }

    reply := make([]byte, 4)
    if _, err := io.ReadFull(conn, reply); err != nil {
        panic(err)
    }
    fmt.Printf("client received: %s\n", reply)

    if err := <-serverDone; err != nil {
        panic(err)
    }
}

预期输出

text
server received: ping
client received: pong

127.0.0.1:0 让操作系统为测试服务端选择一个可用端口,所以示例不会依赖固定端口。客户端通过 ln.Addr().String() 获取实际地址,再发起连接。

读写边界与关闭时机

Write([]byte("ping")) 只是在 TCP 字节流中写入 4 个字节,并没有创建一个名为“ping”的消息。示例之所以能用 io.ReadFull,是因为双方提前约定响应恰好为 4 个字节。真实协议通常需要长度字段、分隔符或其他 framing 规则。

读取如果一直等不到足够字节会持续阻塞,因此线上客户端还应设置超时,例如通过 SetDeadline 限制一次交互的最长等待时间。无论正常结束还是提前返回,都应关闭连接;使用 defer conn.Close() 可以让最小示例在多条错误路径上保持资源释放一致。

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

目录与阅读设置

阅读设置

17

记录一个想法

用 TCP 跑通首个客户端

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

登录哪都通