Go / 系统课时

用 Listener 接收 TCP 连接

用 Listener 接收 TCP 连接

这一节把服务端最核心的接收循环跑起来:创建 net.Listener、调用 Accept 获取连接、处理一条请求并关闭连接。示例可独立运行,并用两个本地客户端验证同一个 Listener 能连续接收多个 TCP 连接。

学习目标

  • 使用 net.Listen 创建 TCP Listener,并理解它与单个连接的区别。
  • 使用 Accept 循环逐个取得 net.Conn。
  • 正确关闭连接,并判断串行处理什么时候会拖慢新的连接接收。

Listener 与 Accept 循环

net.Listener 代表监听端点,本身不是某个客户端的会话。每次 Accept 成功都会返回一个新的 net.Conn,Listener 仍然继续存在,下一次调用可以再接收一个连接。Accept 在没有新连接时阻塞是正常行为,不等于程序卡死。

Listener 接收连接并交给处理函数的流程

跑通可终止的接收循环

为了让示例执行后能够自动结束,接收循环只处理两个连接。生产服务通常会写成持续循环,并在进程退出时主动关闭 Listener。

go
package main

import (
    "bufio"
    "fmt"
    "net"
    "strings"
)

func handleConn(conn net.Conn) error {
    defer conn.Close()

    line, err := bufio.NewReader(conn).ReadString('\n')
    if err != nil {
        return err
    }
    line = strings.TrimSpace(line)

    _, err = fmt.Fprintf(conn, "ack:%s\n", line)
    return err
}

func call(addr, message string) (string, error) {
    conn, err := net.Dial("tcp", addr)
    if err != nil {
        return "", err
    }
    defer conn.Close()

    if _, err := fmt.Fprintf(conn, "%s\n", message); err != nil {
        return "", err
    }
    return bufio.NewReader(conn).ReadString('\n')
}

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() {
        for i := 0; i < 2; i++ {
            conn, err := ln.Accept()
            if err != nil {
                serverDone <- err
                return
            }
            if err := handleConn(conn); err != nil {
                serverDone <- err
                return
            }
        }
        serverDone <- nil
    }()

    for _, message := range []string{"alpha", "beta"} {
        reply, err := call(ln.Addr().String(), message)
        if err != nil {
            panic(err)
        }
        fmt.Print(reply)
    }

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

预期输出

text
ack:alpha
ack:beta

这个结果说明同一个 Listener 连续完成了两次 Accept。两个客户端各自得到独立连接,handleConn 处理完一条以换行结尾的请求后关闭当前连接,但不会关闭 Listener。

把接收连接和业务处理分清

示例在 Accept 后直接调用 handleConn,因此是串行处理:前一个连接没有完成,下一次 Accept 就不会执行。对于教学示例这样最容易观察控制流,但真实服务如果单个请求可能等待数据库、磁盘或下游网络,就会拖慢新连接接收。

常见做法是在接收到连接后把处理工作交给 goroutine 或受控的 worker,再立即回到下一次 Accept。关键不是简单加一个 go,而是同时考虑连接上限、超时、背压和进程退出,否则高并发下可能把 goroutine 与文件描述符耗尽。

验收时先看这几个现象

  • 程序停在 Accept 且 CPU 很低:通常只是正在等待客户端连接。
  • ReadString('\n') 一直不返回:客户端可能没有发送换行符,双方的消息边界约定不一致。
  • 固定端口监听失败并提示地址已被占用:说明已有进程占用了该地址,应释放端口或换端口后再验证。
  • 处理完成后忘记 conn.Close():短期看似正常,持续运行时会逐步消耗文件描述符。

当 Listener 负责“持续接收”,Conn 负责“单次会话”,服务端的基本循环就建立起来了;后续并发化只是在这个边界上把连接处理从串行改为受控并行。

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

目录与阅读设置

阅读设置

17

记录一个想法

用 Listener 接收 TCP 连接

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

登录哪都通