最直接建立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
net.ResolveTCPAddr("tcp4", "127.0.0.1:8080") + net.DialTCP 更可控net.Dial 默认无超时,生产环境必须设超时,推荐用 net.DialTimeout 或更现代的 net.Dialer
net.Dialer
net.Dialer 是比 net.Dial 更灵活的构造方式,尤其适合需要精细控制连接行为的场景(如自定义超时、禁用 Nagle、绑定本地地址等)。
关键参数说明:
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")做有限次数重试for 循环里无休止重试,应设最大尝试次数(如 3 次)和总耗时上限*net.Dialer 实例,避免复用已失效状态net.Conn 关闭后不能再读写net.Conn 是一次性资源,Close() 后所有后续 Read/Write 都会立即返回 io.ErrClosed 或类似错误(如 "use of closed network connection")。这不是 bug,而是设计使然。
容易踩的坑:
conn.Close(),但之后又误用该变量读写conn 传给多个 goroutine 并发操作,未加同步,导致重复关闭或读写竞争conn.SetDeadline 会自动重连 —— 它只影响单次 I/O,超时后连接仍保持打开,但后续操作需手动处理错误并重建连接真正可靠的长连接管理,得靠上层协议心跳 + 显式重连,而不是依赖底层自动恢复。