该用 ListenUDP 还是 DialUDP 取决于是否固定发往同一地址:ListenUDP 返回未连接 conn,适用于服务端监听多客户端或向不同目标发包;DialUDP 返回已连接 conn,适用于点对点通信且读写更简洁。

ListenUDP 和 DialUDP 到底该用哪个?
Go 的 UDP 通信不靠“连接”,而靠 net.ListenUDP 或 net.DialUDP 拿到一个 *net.UDPConn。选哪个,取决于你是不是要“固定发给同一个地址”。
net.ListenUDP 返回的是“未连接”的 conn,适合:
- 服务端监听多个客户端(每个包带源地址,回包用
WriteToUDP) - 客户端要往不同目标发包(比如广播、打洞、上报多个监控地址)
- 不想隐式绑定本地端口,让系统自动分配(传
nil作本地地址)
net.DialUDP 返回的是“已连接”的 conn,适合:
- 点对点简单请求-响应(比如客户端只和一台服务器交互)
- 后续调用
Write和Read更简洁(不用每次都传地址) - 但注意:
Read只收来自 dial 目标的包,内核做了过滤,其他地址的包直接丢
常见错误现象:
立即学习“go语言免费学习笔记(深入)”;
- 写成
net.Listen("udp", ":8080")→ 运行时 panic:「protocol not available」 - 用
DialUDP创建的 conn 调WriteToUDP传了新地址 → 地址被忽略,还是发给 dial 目标 - 用
ListenUDP创建的 conn 调Write→ panic:「write: bad file descriptor」
ReadFromUDP / WriteToUDP 必须配对,别混用 Read/Write
UDP 数据报自带源地址,这是它无连接却能回包的关键。ReadFromUDP 把数据和发送方地址一起读出来;WriteToUDP 把数据和目标地址一起发出去。这两个函数是语义上的一对。
Read 和 Write 是 io 接口方法,但对 UDPConn 来说:
-
Read只在DialUDP创建的 conn 上可用,且只收指定目标的包 -
Write同理,只发给 dial 目标,无法指定任意地址 - 在
ListenUDP的 conn 上调Read或Write→ 运行时报错,信息可能是「use of closed network connection」或「invalid argument」,非常隐蔽
实操建议:
- 服务端一律用
conn.ReadFromUDP(buf)+conn.WriteToUDP(data, addr) - 客户端若用
ListenUDP(比如发日志到多个 endpoint),就别碰Read/Write - 缓冲区
buf长度至少设为65536,否则大包(如 DNS 响应、序列化结构)会被静默截断,n就是实际写入长度,必须检查
超时控制不是可选项,是必填项
UDPConn 默认阻塞,WriteToUDP 在网络异常(比如目标关机、路由中断)时可能卡住几十秒甚至几分钟,等 ICMP 错误回来——这在生产环境等于 goroutine 泄漏。
SetWriteDeadline 和 SetReadDeadline 是唯一靠谱的超时机制:
- 必须在
WriteToUDP前设置,推荐conn.SetWriteDeadline(time.Now().Add(2 * time.Second)) - 超时后 err 是
net.Error类型,要用nerr.Timeout()判断,不能只看err != nil -
SetDeadline是一次性,每次读写前都得重设;SetReadDeadline对ReadFromUDP同样关键,避免收包卡死
Windows 下还有个坑:没设 deadline 就调 ListenUDP,可能触发「address already in use」,尤其开发时频繁重启。
地址解析不能跳,localhost 和 127.0.0.1 可能不是一回事
net.ResolveUDPAddr("udp", "localhost:8080") 在多数系统会解析成 IPv6 地址 ::1,而你的服务端如果只监听 127.0.0.1:8080(IPv4),那就永远收不到包。
实操建议:
- 测试阶段统一用
"127.0.0.1:8080"或":8080"(监听所有接口) - 生产中若需双栈支持,显式解析并分别绑定 IPv4/IPv6 地址
- 目标地址必须是
*net.UDPAddr,不能传字符串;ResolveUDPAddr失败会返回 error,别忽略
缓冲区大小、goroutine 分离、防火墙拦截——这些都不是 Go 特有的问题,而是 UDP 协议层暴露出来的现实约束。写 UDP 代码,本质是在和操作系统网络栈、内核缓冲区、局域网设备打交道,不是写个 Hello World 就完事。


















