Go中处理UDP数据包使用net.UDPConn,支持ListenUDP监听和DialUDP直连;需注意缓冲区大小、地址绑定、连接复用、关闭资源及并发安全。

在 Go 中处理 UDP 数据包主要通过 net.UDPConn 类型完成,它封装了底层 socket 操作,提供阻塞式读写接口。UDP 是无连接、不可靠协议,因此使用时需自行处理丢包、乱序、校验和重传(如需要),但其轻量、低延迟特性非常适合日志上报、监控采集、DNS 查询、游戏心跳等场景。
创建并绑定 UDP 连接
使用 net.ListenUDP 创建监听端口的 UDP 连接;若要向特定地址发送(无需先监听),可用 net.DialUDP 建立“已连接”的 UDPConn(内核会限制只收发该对端数据)。
-
监听任意地址的某个端口:
addr, _ := net.ResolveUDPAddr("udp", ":8080"),然后conn, _ := net.ListenUDP("udp", addr) -
只与固定对端通信(推荐用于客户端):
remote, _ := net.ResolveUDPAddr("udp", "127.0.0.1:9000"),再conn, _ := net.DialUDP("udp", nil, remote)。此后调用conn.Write()不需指定地址,conn.Read()也只接收来自该对端的数据 - 注意:绑定端口时若被占用或权限不足(如 Linux 绑定 1024 以下端口需 root),会返回 error,务必检查
接收 UDP 数据包
UDP 数据报有最大长度限制(通常为 65507 字节,即 IPv4 下 65535 - 8 字节 UDP 头 - 20 字节 IP 头),因此缓冲区应足够大;同时每次 ReadFromUDP 只读取一个完整数据包,不会粘包也不会拆包。
- 使用
buf := make([]byte, 65536)分配足够缓冲区(实际常用 1500 或 8192,视业务而定) -
n, addr, err := conn.ReadFromUDP(buf)返回实际读取字节数、发送方地址和错误;buf[:n]即为原始 UDP 载荷 - 若用
DialUDP创建的连接,则改用n, err := conn.Read(buf),不返回地址(因已限定对端) - 建议启动 goroutine 循环接收,避免阻塞主流程
发送 UDP 数据包
发送方式取决于连接类型:
立即学习“go语言免费学习笔记(深入)”;
- 对
ListenUDP创建的连接,用conn.WriteToUDP(buf, addr)显式指定目标地址 - 对
DialUDP创建的连接,直接conn.Write(buf)即可,目标地址已在 dial 时确定 - UDP 不保证送达,Write 调用成功仅表示数据已交由内核发送队列,不等于对方收到;无超时机制,如需控制可配合
SetDeadline或SetWriteDeadline - 若需广播,绑定地址应设为
"0.0.0.0:port"并启用 socket 广播选项:conn.SetWriteBuffer(65536)后调用conn.(*net.UDPConn).SyscallConn().Control(...)(较底层,一般用net.Interface查广播地址后发)
资源管理与常见陷阱
UDPConn 是系统资源,用完必须关闭;同时注意并发安全——ReadFromUDP 和 WriteToUDP 是并发安全的,但多个 goroutine 共享同一连接时仍需注意逻辑顺序。
- 务必在不再使用时调用
conn.Close(),否则 fd 泄露 - 不要在循环中反复
ListenUDP/DialUDP,应复用连接;高频小包场景下频繁建连开销大且易耗尽端口 - 接收时若缓冲区太小,超出部分会被截断(Go 不报错,只返回实际读取长度),务必确保 buf 足够或根据协议设计合理 MTU
- IPv4/IPv6 双栈支持:使用
"udp4"或"udp6"显式指定,或用"udp"让系统自动选择(通常优先 IPv6)










