Golang实现简单的Socket通信示例

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