最直接建立TCP连接用net.Dial,需指定"host:port"格式;生产环境应使用net.Dialer设Timeout等参数;连接失败时对超时、拒绝类错误可指数退避重试;net.Conn关闭后不可再读写。

如何用 net.Dial 建立基础 TCP 连接
最直接的方式就是调用 net.Dial,它会自动解析地址、建立连接并返回 net.Conn。注意:默认使用 "tcp" 网络类型,地址格式必须是 "host:port"(如 "127.0.0.1:8080"),不能省略端口或写成 "127.0.0.1"。
常见错误现象:dial tcp: address 127.0.0.1: missing port in address 或 dial tcp 127.0.0.1:0: connect: connection refused,前者是格式错,后者通常是服务未监听或防火墙拦截。
- 务必检查目标服务是否已启动且监听在对应
IP:Port - 若需 IPv4 优先,显式用
net.ResolveTCPAddr("tcp4", "127.0.0.1:8080")+net.DialTCP更可控 -
net.Dial默认无超时,生产环境必须设超时,推荐用net.DialTimeout或更现代的net.Dialer
如何设置连接超时与底层控制 —— 用 net.Dialer
net.Dialer 是比 net.Dial 更灵活的构造方式,尤其适合需要精细控制连接行为的场景(如自定义超时、禁用 Nagle、绑定本地地址等)。
关键参数说明:
立即学习“go语言免费学习笔记(深入)”;
-
Timeout:建立 TCP 握手的总时间上限(不含 DNS 解析) -
KeepAlive:启用 TCP keepalive 及其间隔(设为0表示禁用) -
LocalAddr:指定本地绑定的net.Addr,可用于多网卡出口控制 -
Control:在 socket 创建后、connect 前执行的回调,可 setsockopt(如TCP_NODELAY)
func main() {
d := &net.Dialer{
Timeout: 5 * time.Second,
KeepAlive: 30 * time.Second,
}
conn, err := d.Dial("tcp", "example.com:80")
if err != nil {
log.Fatal(err)
}
defer conn.Close()
}如何处理连接异常与重试逻辑
TCP 连接失败不等于永久失败。常见可恢复错误包括:dial tcp i/o timeout、connection refused(服务瞬时不可达)、no route to host(网络抖动)。但 invalid argument 或解析失败类错误不应重试。
建议做法:
- 对临时性错误(
net.OpError且Err是os.SyscallError或包含"timeout"/"refused")做有限次数重试 - 每次重试前加指数退避(如 100ms → 200ms → 400ms)
- 避免在
for循环里无休止重试,应设最大尝试次数(如 3 次)和总耗时上限 - 重试时重新创建
*net.Dialer实例,避免复用已失效状态
为什么 net.Conn 关闭后不能再读写
net.Conn 是一次性资源,Close() 后所有后续 Read/Write 都会立即返回 io.ErrClosed 或类似错误(如 "use of closed network connection")。这不是 bug,而是设计使然。
容易踩的坑:
- 在 defer 中调用
conn.Close(),但之后又误用该变量读写 - 把
conn传给多个 goroutine 并发操作,未加同步,导致重复关闭或读写竞争 - 误以为
conn.SetDeadline会自动重连 —— 它只影响单次 I/O,超时后连接仍保持打开,但后续操作需手动处理错误并重建连接
真正可靠的长连接管理,得靠上层协议心跳 + 显式重连,而不是依赖底层自动恢复。










