使用 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 会被阻塞。
立即学习“go语言免费学习笔记(深入)”;
- 主循环里对每个
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 实现简洁,但流式协议的边界处理、连接生命周期管理、错误恢复这些地方,容易在测试通过后上线才暴露问题。别依赖“看起来能通”,多测断网、快速重连、大包分片场景。










