在 C# 中实现 UDP 通信主要靠
UdpClient类,它封装了底层 socket 操作,使用简单、适合无连接、低延迟场景(如局域网设备发现、实时音视频辅助信令、游戏心跳包等)。
创建 UdpClient 发送数据
发送端不需要绑定端口,直接构造
UdpClient后调用
Send()即可: 指定目标 IP 和端口,把字节数组发出去 注意编码统一(推荐 UTF8),避免中文乱码 UDP 不保证送达,也不确认接收,应用层需自行处理超时或重传
示例:
var client = new UdpClient();
var data = Encoding.UTF8.GetBytes("Hello from UDP sender!");
client.Send(data, data.Length, "127.0.0.1", 8080);
client.Close(); // 发完及时释放
用 UdpClient 接收数据
接收端必须绑定本地端口(
new UdpClient(8080)或
client.Client.Bind()),再用
Receive()阻塞等待数据:
Receive()返回接收到的字节数组,并通过
ref IPEndPoint输出发送方地址 建议用
try/catch处理 SocketException(如端口被占、权限不足) 若需持续监听,应放在循环中,但避免空转占用 CPU,可用
client.Available > 0判断是否有数据
示例:
using var server = new UdpClient(8080);
IPEndPoint remote = null;
while (true)
{
try
{
var data = server.Receive(ref remote);
string msg = Encoding.UTF8.GetString(data);
Console.WriteLine($"[{remote}] {msg}");
}
catch (SocketException ex) when (ex.SocketErrorCode == SocketError.Interrupted)
{
break; // 如关闭时触发
}
}
同步 vs 异步:推荐用异步避免阻塞
生产环境不建议用
Receive()阻塞主线程。更稳妥的方式是用异步方法:
ReceiveAsync()返回
ValueTask<udpreceiveresult></udpreceiveresult>,支持 await
UdpReceiveResult包含
Buffer、
RemoteEndPoint,语义清晰 配合
CancellationToken可安全取消监听
简写示例:
async Task ListenLoop(UdpClient client, CancellationToken ct)
{
while (!ct.IsCancellationRequested)
{
var result = await client.ReceiveAsync(ct);
string msg = Encoding.UTF8.GetString(result.Buffer);
Console.WriteLine($"← {result.RemoteEndPoint}: {msg}");
}
}
注意事项和常见问题
UDP 是无连接协议,C# 的
UdpClient虽易用,但几个细节容易踩坑: 防火墙可能拦截 UDP 入站流量,测试前先关防火墙或添加规则 跨网段通信需确保路由可达,广播地址(如 255.255.255.255)仅限局域网且需开启
EnableBroadcast = true单次
Send()建议不超过 64KB(实际受 MTU 限制,通常 ≤1400 字节更稳妥) 多个线程共用一个
UdpClient实例是线程安全的,但
ReceiveAsync()不允许多个并发调用
基本上就这些。UDP 本身不复杂,但可靠性和边界处理得靠你自己补。
