.NET MAUI（Android平台）UDP广播发送失败排查求助

一、补充权限与MulticastLock配置 #

1. 更新AndroidManifest.xml权限
   除已配置的INTERNET，需额外添加以下权限到Android项目的AndroidManifest.xml中：

   <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
   <uses-permission android:name="android.permission.CHANGE_WIFI_MULTICAST_STATE" />
   

   这两个权限是Android系统允许应用发送广播/多播数据包的必要前提。

2. 获取并持有MulticastLock
   MAUI中需通过Android原生API获取MulticastLock，在UDP发送逻辑执行前加锁，发送完成后释放。示例实现：

   using Android.Content;
   using Android.Net.Wifi;
   
   private WifiManager.MulticastLock _multicastLock;
   
   public void AcquireMulticastLock()
   {
       var wifiManager = (WifiManager)Android.App.Application.Context.GetSystemService(Context.WifiService);
       _multicastLock = wifiManager.CreateMulticastLock("UdpBroadcastLock");
       _multicastLock.Acquire();
   }
   
   public void ReleaseMulticastLock()
   {
       _multicastLock?.Release();
   }
   

二、UDP发送代码优化 #

1. 替换全广播地址为子网广播地址
   255.255.255.255在部分网络环境中会被路由器拦截，建议获取当前WiFi子网的广播地址：

   private IPAddress GetWifiBroadcastAddress()
   {
       foreach (var ip in Dns.GetHostEntry(Dns.GetHostName()).AddressList)
       {
           if (ip.AddressFamily == System.Net.Sockets.AddressFamily.InterNetwork)
           {
               // 针对常见的255.255.255.0子网掩码生成广播地址，可根据实际网络调整
               var ipBytes = ip.GetAddressBytes();
               ipBytes[3] = 255;
               return new IPAddress(ipBytes);
           }
       }
       return IPAddress.Parse("255.255.255.255"); // 兜底方案
   }
   

2. 优化发送逻辑
   使用using语句确保UdpClient正确释放，同时明确配置Socket选项：

   var dataToBeSend = "What ever ...";   
   var data = Encoding.UTF8.GetBytes(dataToBeSend);
   var broadcastAddress = GetWifiBroadcastAddress();
   const int BroadcastPort = 12345; // 替换为你的目标端口
   
   // 先获取锁
   AcquireMulticastLock();
   
   using (var udpClient = new UdpClient())
   {
       udpClient.ExclusiveAddressUse = false;
       udpClient.EnableBroadcast = true;
       udpClient.Client.SetSocketOption(SocketOptionLevel.Socket, SocketOptionName.Broadcast, true);
       udpClient.Send(data, data.Length, broadcastAddress.ToString(), BroadcastPort);
   }
   
   // 发送完成后释放锁
   ReleaseMulticastLock();
   

三、排查测试要点 #

• 确认UDP接收端已启动，监听端口与发送端BroadcastPort完全一致，且处于同一WiFi网络。
• 用Wireshark在接收端或路由器上抓包，验证UDP数据包是否实际发出。
• 关闭测试设备的WiFi节能模式，部分Android设备在节能模式下会限制网络广播行为。

内容的提问来源于stack exchange，提问作者displayname