17370845950

使用 net.Listen 启动 TCP 服务端需注意：监听地址格式（如 ":8080" 绑定所有网卡，"localhost:8080" 仅限回环）；端口

Go 里用 net.Listen 启动 TCP 服务端要注意什么

Go 的 net.Listen 是启动 TCP 服务端的第一步，但新手常卡在地址格式和端口占用上。监听地址必须是 "host:port" 格式，"localhost:8080" 和 ":8080" 效果不同：":8080" 绑定所有网卡（包括外网），而 "localhost:8080" 只响应本地回环请求。

• 端口小于 1024 需要 root 权限（Linux/macOS）
• 如果报错 "listen tcp :8080: bind: address already in use"，说明端口被占，可用 lsof -i :8080（macOS/Linux）或 netstat -ano | findstr :8080（Windows）查进程
• 务必在 defer listener.Close() 前启动 for 循环接受连接，否则服务端一启动就退出

客户端用 net.Dial 连接失败的常见原因

net.Dial("tcp", "127.0.0.1:8080", nil) 看似简单，但实际失败往往不是代码问题，而是环境不匹配：

• 服务端没运行，或监听的是 "localhost:8080" 而客户端连 "127.0.0.1:8080"（某些系统 DNS 解析行为导致不等价）
• 防火墙拦截了连接（特别是 Windows 默认启用防火墙）
• 客户端未设置超时，net.Dial 默认阻塞直到连接建立或系统超时（可能长达数分钟），应改用 net.DialTimeout

conn, err := net.DialTimeout("tcp", "127.0.0.1:8080", 5*time.Second)
if err != nil {
    log.Fatal(err)
}

读写数据时为什么 conn.Read 会卡住或只读到部分数据

TCP 是流式协议，conn.Read 不保证一次读完所有发送内容，它只返回当前缓冲区中已到达的字节（可能少于预期）。同样，conn.Write 也不保证一次发完全部字节（虽然小数据通常没问题）。

• 不要假设 Read 会填满整个 []byte 切片；检查返回的 n 值
• 没有消息边界，需自行定义协议：比如每条消息以换行符结尾，或头部带 4 字节长度字段
• 服务端用 bufio.Scanner 按行读取更安全；客户端发完后调用 conn.CloseWrite()（可选）通知服务端“写完了”

服务端如何同时处理多个客户端连接

Go 的 goroutine 让并发处理变得简单，但关键在于：每个 conn 必须在独立 goroutine 中处理，否则后续 Accept 会被阻塞。

• 主循环里对每个 conn 启动 goroutine：go handleConnection(conn)
• 避免在 handleConnection 中直接使用闭包变量捕获 conn，容易因循环变量复用出错（写成 go func(c net.Conn) { ... }(conn) 更稳妥）
• 注意资源泄漏：客户端异常断开时，Read 会返回 io.EOF 或网络错误，此时应主动 conn.Close()

for {
    conn, err := listener.Accept()
    if err != nil {
        log.Printf("accept error: %v", err)
        continue
    }
    go func(c net.Conn) {
        defer c.Close()
        // 处理逻辑...
    }(conn)
}

Go 的 socket 实现简洁，但流式协议的边界处理、连接生命周期管理、错误恢复这些地方，容易在测试通过后上线才暴露问题。别依赖“看起来能通”，多测断网、快速重连、大包分片场景。