Golang实现TCP长连接与心跳机制详解

Golang实现TCP长连接需结合心跳机制和重连逻辑。1. 使用net.Dial和net.Listen建立基础连接；2. 通过goroutine持续读写通信；3. 引入定时心跳检测连接状态，客户端每5秒发送“ping”，服务端响应“pong”；4. 检测失败时触发重连机制，尝试重新Dial并重启通信协程；5. 心跳间隔一般设为3~10秒以平衡及时性和负载。

在使用 Golang 实现 TCP 通信时，长连接（即保持连接不断开）是很多场景下的基本需求，比如聊天服务、实时数据推送等。要实现一个稳定的 TCP 长连接通信，除了基础的 net.Conn 使用外，还需要结合心跳机制来维持连接状态。

建立基本的 TCP 连接

Golang 的 net 包提供了非常方便的接口来建立 TCP 通信。客户端通过 net.Dial 拨号服务器，服务器端用 net.Listen 监听并接受连接。

conn, err := net.Dial("tcp", "127.0.0.1:8080")
if err != nil {
    log.Fatal("连接失败:", err)
}

这样就建立了一个 TCP 连接。但默认情况下，这个连接不会自动维持，一旦断开或超时就会失效。所以需要我们自己处理连接的保活和重连。

使用 net.Conn 进行持续通信

拿到 net.Conn 对象之后，就可以用它的 Read() 和 Write() 方法进行读写操作了。为了维持长连接，通常会在一个 goroutine 中循环读取服务器发来的消息。

go func() {
    buf := make([]byte, 1024)
    for {
        n, err := conn.Read(buf)
        if err != nil {
            log.Println("读取失败:", err)
            return
        }
        log.Printf("收到消息: %s\n", buf[:n])
    }
}()

同时也可以在主线程或其他 goroutine 中发送消息：

_, err := conn.Write([]byte("Hello Server"))
if err != nil {
    log.Println("发送失败:", err)
}

不过光靠这些还不够稳定，因为网络不稳定时连接可能中断，而 Read/Write 可能并不会立刻返回错误。

心跳机制：让连接“活着”

为了检测连接是否有效，以及防止中间设备（如路由器、防火墙）主动断开空闲连接，我们需要引入心跳机制。

常见做法是在客户端定时发送一个小包（比如每 5 秒一次），服务器收到后回复确认。

ticker := time.NewTicker(5 * time.Second)
go func() {
    for {
        select {
        case <-ticker.C:
            _, err := conn.Write([]byte("ping"))
            if err != nil {
                log.Println("发送心跳失败:", err)
                // 在这里可以触发重连逻辑
                return
            }
        }
    }
}()

服务器端也需要配合处理：

if string(buf[:n]) == "ping" {
    conn.Write([]byte("pong"))
}

客户端收到 “pong” 表示连接正常；如果连续几次没收到回应，就可以认为连接已断开，需要重新拨号。

小贴士：心跳频率不能太低也不能太高。太低的话可能无法及时发现断线，太高又会增加网络负担。一般设置为 3~10 秒比较合适。

处理连接断开与重连

当检测到连接异常时，应该尝试重新连接。可以在心跳失败时启动一个重试逻辑，比如每隔几秒尝试重新 Dial。

func reconnect(addr string) (net.Conn, error) {
    var conn net.Conn
    var err error
    for i := 0; i < 5; i++ {
        conn, err = net.Dial("tcp", addr)
        if err == nil {
            return conn, nil
        }
        time.Sleep(3 * time.Second)
    }
    return nil, err
}

重连成功后，记得重启之前的消息读取协程，并恢复心跳机制。

基本上就这些。TCP 长连接的核心在于持续通信 + 心跳检测 + 断线重连三者结合，其中 net.Conn 是整个流程的基础。虽然不复杂，但细节上容易忽略，比如心跳间隔、异常判断、并发控制等，都需要根据具体业务场景做适当调整。