Go net包支持高并发TCP但需避四坑:单协程阻塞(Accept后立即启goroutine)、空闲断连(SetReadDeadline实现心跳)、粘包(读写分离+解包)、连接泄漏(读写协程协同关闭)。

Go 原生 net 包完全支持高并发长连接 TCP,但默认写法极易掉进「单协程阻塞」「空闲断连」「粘包无处理」「连接泄漏」四个坑。关键不是“能不能”,而是“怎么设超时、怎么分读写、怎么保活、怎么收尾”。
net.Listen + goroutine 是基础,但 Accept 后必须立刻启协程
很多人写完 listener.Accept() 就直接在主循环里 conn.Read(),结果一个客户端卡住,整个服务器就堵死。正确做法是每个连接立即丢进新 goroutine:
-
for循环里只做Accept,不碰Read/Write - 每次
Accept成功后,立刻go handleConn(conn),哪怕只是 echo 也得这样 - 别在
handleConn里 deferconn.Close()就完事——要等读写都结束再关,否则可能中断正在写的响应
SetReadDeadline 是心跳和防断连的核心,不是可选项
TCP 层没心跳,NAT、防火墙、云厂商 LB 默认 5~30 分钟空闲就 kill 连接。靠 conn.SetReadDeadline() 主动探测比等 EOF 更可靠:
- 每次
conn.Read()前,调用conn.SetReadDeadline(time.Now().Add(30 * time.Second)) - 如果
Read()返回err != nil且err.(net.Error).Timeout()为 true,说明超时——大概率是客户端挂了或网络中断,该关连接 - 收到任何有效数据(包括
"ping")后,立刻重置 deadline,形成应用层心跳 - 别用
SetDeadline,它同时影响读写;长连接中写操作通常由业务触发,不应被读超时牵连
读写分离能避免 goroutine 阻塞和粘包错乱
把 Read 和 Write 放同一个 goroutine 容易因写阻塞导致读超时误判,也难处理粘包。推荐拆成两个:
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器,提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象,支持命名依赖等
立即学习“go语言免费学习笔记(深入)”;
- 读协程:只负责
Read→ 解包(比如按换行或自定义头)→ 发到chan []byte或结构体 - 写协程:从 channel 拿消息 →
Write→ 处理写失败(如对方已断开,Write会 panic 或返回io.ErrClosedPipe) - 用
sync.Once或atomic.Bool标记连接是否已关闭,防止双协程重复 close - 如果协议简单(如行分隔),用
bufio.Scanner比裸Read更安全;若二进制协议,必须自己解析包头长度字段
连接池和重连逻辑不在 server 侧,而在 client 侧才合理
服务端不该管“哪个连接该复用”,那是客户端的事。但 server 必须容忍 client 的反复断连重连:
- 不要用全局 map 存所有
conn并手动管理生命周期——goroutine 自带退出机制,靠defer conn.Close()+ 超时判断更轻量 - client 断连重连时,server 可能还在往旧 conn 写数据,此时
Write会返回broken pipe或use of closed network connection,必须检查并跳过 - 如果真需要连接复用(比如 client 是设备端资源受限),应在 client 实现指数退避重连:
1s → 2s → 4s → ……,而不是让 server 等着它 - server 端唯一要做的,是确保
Accept不阻塞、每个conn有独立超时、错误时不 panic
最常被忽略的其实是连接关闭时机:不是收到 EOF 就立刻关,而是要等读协程退出、写协程清空 channel、所有 pending write 完成后再 close。否则容易出现 half-close 状态,client 收不到最后几字节。

















