简介：一份面向Windows网络编程开发者的UDP组播（多播）工程示例，基于Winsock应用程序接口实现数据报的发送与接收，适合正在学习网际协议多播原理、练习套接字编程的入门或进阶开发者参考。资源包共36个文件，整体大小仅315KB，包含Visual Studio工程文件、C++源代码、头文件、目标文件以及调试信息等，结构紧凑，可直接用Visual Studio打开编译，快速搭建组播收发测试环境。压缩包内发送与接收两个子工程划分清晰，分别对应发送端和接收端，完整演示了加入多播组、设置网络接口、绑定端口、发送与接收数据、关闭套接字等关键步骤，并结合实际代码展示了WIN32环境下的组播配置细节。已有1680人学习或下载，对于希望理清UDP组播在Windows平台下落地实现、掌握多播套接字选项设置的应用开发者，是一份简洁实用的参考工程。
1. UDP组播收发程序：排查网络问题时最趁手的调试工具
在 Windows 下用 Visual Studio 调试局域网服务时，经常遇到「网络包发出去了，另一台机器就是收不到」的玄学问题。单播可以排查 IP、端口、防火墙，广播又会造成全网冲击，于是 UDP 组播成了最常用的中间态：同一份数据只发给加入同一组播组的成员，非常适合做服务发现、状态同步和设备控制。这个项目就是一个可在 VS 里直接编译运行的 UDP 组播发送与接收程序，发送端支持自定义目标组播地址、端口、发送间隔和报文内容，接收端可以实时显示组播数据并统计收包数。不管你是在调网络协议，还是想给局域网内的多台设备同步数据，都可以拿它当基础模板改一改。
2. 组播原理与工程选型：为什么 Windows 下要单独写一套收发程序
2.1 组播地址与端口怎么选
组播地址属于 D 类地址，范围是 224.0.0.0 到 239.255.255.255。其中 224.0.0.0 到 224.0.0.255 是保留段，用于本地链路协议，不能随意使用，比如 224.0.0.1 代表所有组播主机，224.0.0.2 代表所有组播路由器。真正可分配给应用的是 224.0.1.0 到 238.255.255.255，以及 239.0.0.0 到 239.255.255.255，其中 239 开头的管理限定地址最适合局域网调试，因为路由器默认不会向外转发。
端口选择上，UDP 组播和普通 UDP 没有区别，仍然是 0 到 65535。但在 Windows 下，接收端绑定的端口必须和发送端目标端口一致，否则内核不会把报文投递到你的套接字。程序中我建议用 45678 这类高位端口，避开系统服务常用的 1024 以下端口，也避开可能被其他调试工具占用的 5000、8000 等热门端口。
2.2 技术栈：WinSock2 与 Visual Studio 工程配置
这个项目基于 WinSock2 编写，对应winsock2.h头文件和ws2_32.lib链接库。工程上我建立了两个互相独立的控制台应用：一个做发送端，一个做接收端。这样在 VS 里可以先启动接收端再启动发送端，调试时不用来回切窗口，也能分别设置不同项目的启动参数。
创建工程时注意，VS 自带的空项目模板默认不会链接ws2_32.lib，需要在「项目属性 -> 链接器 -> 输入 -> 附加依赖项」里手动加上；更省事的做法是代码里写#pragma comment(lib, "ws2_32.lib")，让编译器直接把依赖链入。字符集选择上，如果你的报文内容要支持中文，建议把「项目属性 -> 常规 -> 字符集」设为「使用多字节字符集」，或者代码里统一用 UTF-8 并在发送前转码。我习惯用多字节字符集，因为组播调试场景里大部分报文是 ASCII 可见字符，最省事。
工程结构上，发送端和接收端共用一个Common.h头文件，里面定义了组播地址、端口、缓冲区大小等常量：
#pragma once #define WIN32_LEAN_AND_MEAN #include <winsock2.h> #include <ws2tcpip.h> #include <stdio.h> #include <string.h> #pragma comment(lib, "ws2_32.lib") #define MULTICAST_ADDR "239.255.0.100" // 组播地址 #define MULTICAST_PORT 45678 // 组播端口 #define BUFFER_SIZE 1024 // 接收缓冲这里把 Winsock 相关的头文件固定成winsock2.h，避免和windows.h里的旧版 socket 定义冲突。WIN32_LEAN_AND_MEAN是为了裁剪 Windows 头文件的体积，防止某些宏定义干扰 Winsock 的 API。
3. 发送端核心实现：构造组播报文与自动重发机制
3.1 发送端初始化：创建套接字、设置 TTL、指定出口网卡
发送端的第一步是调用WSAStartup初始化 Winsock 环境，这个函数需要传入请求的版本号MAKEWORD(2, 2)，并返回WSADATA结构。初始化成功后，用socket(AF_INET, SOCK_DGRAM, IPPROTO_UDP)创建一个 UDP 套接字，SOCK_DGRAM表示数据报套接字。
接着最关键的一步是设置 TTL，也就是组播报文的存活时间。TTL 值决定报文能在网络中穿越多少跳，默认值在不同系统上不一样，Windows 下如果不设置，默认可能是 1，这就导致报文只在本机或直连网段内有效。如果要多级路由转发，需要增大 TTL。
另一个容易踩坑的是多网卡机器。一个 Windows 主机上可能有有线网卡、无线网卡和虚拟网卡，组播报文默认从系统选中的网卡发出，可能不是你期望的那块。正确做法是枚举本机网卡，把想要使用的网卡 IP 通过IP_MULTICAST_IF选项绑定到套接字上。
SOCKET sendSock; struct sockaddr_in localAddr; sendSock = socket(AF_INET, SOCK_DGRAM, IPPROTO_UDP); if (sendSock == INVALID_SOCKET) { printf("socket failed: %d\n", WSAGetLastError()); return 1; } // 设置组播 TTL，允许跨网段 unsigned char ttl = 16; setsockopt(sendSock, IPPROTO_IP, IP_MULTICAST_TTL, (char*)&ttl, sizeof(ttl)); // 指定出口网卡 IP，这里用 192.168.1.100 示例 struct in_addr localItf; localItf.s_addr = inet_addr("192.168.1.100"); setsockopt(sendSock, IPPROTO_IP, IP_MULTICAST_IF, (char*)&localItf, sizeof(localItf)); // 初始化目标组播地址结构 struct sockaddr_in remoteAddr; memset(&remoteAddr, 0, sizeof(remoteAddr)); remoteAddr.sin_family = AF_INET; remoteAddr.sin_port = htons(MULTICAST_PORT); remoteAddr.sin_addr.s_addr = inet_addr(MULTICAST_ADDR);这段代码里IP_MULTICAST_TTL的选项级别是IPPROTO_IP，和常用的SOL_SOCKET不一样，写错的后果是setsockopt直接返回失败，而调用WSAGetLastError时错误码往往会指向无效参数。IP_MULTICAST_IF设置的 exit 接口是网卡的 IP 地址，不是网卡名也不是 MAC 地址，这一点和 Linux 下的setsockopt参数值类型基本一致，但传给 Windows 的setsockopt时结构体字段需要手动赋 IP 值。
3.2 循环发送与状态反馈
发送端进入while循环后，可以按固定间隔发送自定义报文。这里我加了一个序号字段，方便接收端判断报文是否乱序或丢失。发送函数sendto的参数里，目标地址就是刚才构造的remoteAddr，返回值是实际发送的字节数，如果返回SOCKET_ERROR，需要用WSAGetLastError拿到错误码定位问题。
char buffer[BUFFER_SIZE]; int seq = 0; while (1) { // 构造一个带序号和时间戳的报文 snprintf(buffer, sizeof(buffer), "HELLO_MCAST seq=%d time=%lu", seq++, GetTickCount64()); int ret = sendto(sendSock, buffer, (int)strlen(buffer), 0, (struct sockaddr*)&remoteAddr, sizeof(remoteAddr)); if (ret == SOCKET_ERROR) { printf("sendto failed: %d\n", WSAGetLastError()); break; } printf("[send] %s (%d bytes)\n", buffer, ret); Sleep(1000); // 每次发送后休眠 1 秒 }sleep这里用的是 Windows 的Sleep，单位是毫秒，把 1000 改成 500 就是每 0.5 秒发一帧。如果你在调试设备发现协议的交互节奏，往往需要把间隔调到 10 毫秒甚至 1 毫秒，这时候要注意Sleep(1)实际精度不到 1 毫秒，用timeBeginPeriod(1)可以提高系统定时器精度，或者改用select超时来实现更准确的等待。GetTickCount64()返回的是开机以来的毫秒数，用来标记发送时间很方便，但它是相对时间，不是 UTC 时间戳，接收端如果要做跨设备时延计算，需要同时传本机启动时间和当前时间。
4. 接收端核心实现：加入组播组、绑定端口与数据解析
4.1 接收端初始化：SO_REUSEADDR 与绑定本地端口
接收端和发送端最大的区别是必须绑定端口，并且要主动加入组播组。绑定端口时，很多新手直接写bind(sock, (struct sockaddr*)&localAddr, sizeof(localAddr))并把localAddr.sin_addr.s_addr设成INADDR_ANY，这样绑的是本地所有地址的45678端口，本身没问题。但如果同一台机器上有多个组播程序都在监听同一个端口，默认情况下的绑定会冲突，要么后启动的失败，要么两个进程互踢。
解决办法是在绑定之前设置SO_REUSEADDR。这个选项的语义在 Windows 上比 Linux 复杂一点，它会允许多个套接字同时绑定同一端口，前提是组播地址也相同。如果只是单进程单套接字，设不设这个选项都能跑，但我在调试时经常同一机器开多个接收端对比报文，所以统一设置。
SOCKET recvSock; struct sockaddr_in localAddr; recvSock = socket(AF_INET, SOCK_DGRAM, IPPROTO_UDP); // 允许端口复用，方便多实例调试 int reuse = 1; setsockopt(recvSock, SOL_SOCKET, SO_REUSEADDR, (char*)&reuse, sizeof(reuse)); memset(&localAddr, 0, sizeof(localAddr)); localAddr.sin_family = AF_INET; localAddr.sin_port = htons(MULTICAST_PORT); localAddr.sin_addr.s_addr = htonl(INADDR_ANY); int ret = bind(recvSock, (struct sockaddr*)&localAddr, sizeof(localAddr)); if (ret == SOCKET_ERROR) { printf("bind failed: %d\n", WSAGetLastError()); }INADDR_ANY是 0.0.0.0 的宏，用htonl(INADDR_ANY)和直接INADDR_ANY效果一样，因为 0 的字节序反转还是 0。绑定地址如果写成本机具体 IP，则只会收到目的地址是该 IP 或组播地址的数据，但绑定具体 IP 有一个副作用：Windows 有时会把组播包统一从默认网卡旁的逻辑接口收进来，导致你收不到其他网卡上的组播流。
4.2 加入组播组与 recvfrom 循环
在bind之后，需要调用setsockopt并设置IP_ADD_MEMBERSHIP来加入组播组。这个选项的值是一个struct ip_mreq结构，里面包含imr_multiaddr和imr_interface两个字段。imr_multiaddr是要加入的组播地址，imr_interface是本机网卡 IP。如果imr_interface设为INADDR_ANY，系统会自动选择一个网卡加入组播组，通常能收到默认网卡的组播包，但不保证是全部网卡。
struct ip_mreq mreq; memset(&mreq, 0, sizeof(mreq)); mreq.imr_multiaddr.s_addr = inet_addr(MULTICAST_ADDR); mreq.imr_interface.s_addr = htonl(INADDR_ANY); // 也可以用具体网卡 IP ret = setsockopt(recvSock, IPPROTO_IP, IP_ADD_MEMBERSHIP, (char*)&mreq, sizeof(mreq)); if (ret == SOCKET_ERROR) { printf("IP_ADD_MEMBERSHIP failed: %d\n", WSAGetLastError()); return 1; }组播加入成功后，接收端就进入recvfrom循环了。这里我把recvfrom设计成带超时的模式，使用setsockopt配合SO_RCVTIMEO设置接收超时，这样可以让主循环每 500 毫秒醒一次，即使没有数据也能刷新统计界面，不会阻塞在recvfrom里永远出不来。
DWORD timeout = 500; setsockopt(recvSock, SOL_SOCKET, SO_RCVTIMEO, (char*)&timeout, sizeof(timeout)); char buffer[BUFFER_SIZE]; struct sockaddr_in fromAddr; int fromLen = sizeof(fromAddr); int timeoutCount = 0; while (1) { int len = recvfrom(recvSock, buffer, BUFFER_SIZE - 1, 0, (struct sockaddr*)&fromAddr, &fromLen); if (len == SOCKET_ERROR) { int err = WSAGetLastError(); if (err == WSAETIMEDOUT) { timeoutCount++; printf("[wait] receive timeout, count=%d\n", timeoutCount); continue; } printf("recvfrom error: %d\n", err); break; } buffer[len] = '\0'; printf("[recv] %s, from %s:%d\n", buffer, inet_ntoa(fromAddr.sin_addr), ntohs(fromAddr.sin_port)); }WSAETIMEDOUT错误码只有在设置了SO_RCVTIMEO之后才会出现，它是 10060。如果不设置超时，recvfrom会一直阻塞，关程序时只能强制终止进程。inet_ntoa返回的字符串是静态缓存，下一次再调用会被覆盖，如果要把来源 IP 保存下来，必须用strcpy复制到自己分配的缓冲区中。
5. 常见问题避坑：组播收不到包时的排查路线
5.1 防火墙拦截导致发送端 100% 丢包
现象：发送端一直打印sendto 成功，接收端却一行数据也没输出，Netstat或抓包工具看不到任何组播包。
原因：Windows 防火墙默认拦截传入的 UDP 数据报，尤其是来自子网外或标记为不安全的组播流量。即使你在同一个局域网内，某些杀毒软件的网络防护也会静默丢弃组播包，发送端没有返回值，因为这个丢包发生在协议栈之外。
解决：打开「控制面板 -> Windows Defender 防火墙 -> 高级设置 -> 入站规则」，新建一条允许 UDP 端口45678的规则，作用域限定在本地子网。如果只做开发调试，也可以临时关闭防火墙，但记得测完立刻打开。还有一个更隐蔽的点：发送端自身的出站规则也可能被拦截，出站 UDP 到组播地址的报文有时候会被云安全客户端收走，需要检查安全软件的日志。
5.2 多网卡环境下数据从错误网卡发出
现象：主机上同时有以太网和 Wi-Fi，发送端设置的是 Wi-Fi 网段的组播地址，但接收端在以太网线缆上的另一台机器永远收不到。
原因：sendto的时候，系统根据目标地址和路由表选择出口网卡，如果没设置IP_MULTICAST_IF，组播报文可能走了默认路由对应的网卡，而不是加入了同一组播组的那个网卡。
解决：发送端强制设置出口 IP，接收端加入组播组时也绑定同网段 IP。更通用的做法是用GetAdaptersAddresses枚举所有网卡，过滤出Up状态的接口，让用户通过命令行参数选择。顺序上一定先设置IP_MULTICAST_IF，再调用sendto，因为IP_MULTICAST_IF改变的是套接字的出口属性，每次发送都会使用这个属性，不是一次性参数。
5.3 同机收发失效：回环模式没开
现象：接收端和发送端在同一台 Windows 机器上，接收端收不到发送端发出去的组播包，但在另一台机器上能收到。
原因：组播默认会回环到本机吗？Windows 的组播回环默认是开启的，但有些网络驱动或虚拟网卡环境会关闭。更常见的坑是接收端绑定端口时没设置SO_REUSEADDR，发送端也没有主动设置回环，导致本机发出的组播报文无法进入本机接收队列。
解决：在发送端主动设置IP_MULTICAST_LOOP为允许回环：
int loop = 1; setsockopt(sendSock, IPPROTO_IP, IP_MULTICAST_LOOP, (char*)&loop, sizeof(loop));如果设了IP_MULTICAST_IF指定了某个特定网卡，而接收端绑定在INADDR_ANY上，回环机制有时还是能收到，但最保险的做法是收发两端都指定同网卡 IP。同机调试时，组播地址偶尔会和本机虚拟网卡冲突，建议先只用一张物理网卡。
5.4 绑定地址选错导致接收失败
现象：接收端绑定到192.168.1.10这个具体 IP，然后在另一块网卡192.168.2.33上发送组播，接收端收不到；换成INADDR_ANY就收到了。
原因：Windows 的组播实现中，绑定到单播 IP 会让套接字只监听该 IP 对应的数据路径。当组播报文从另一块网卡进入时，内核组播成员关系是在另一个网络接口上维护的，所以recvfrom不会收到数据。
解决：普通接收场景直接绑定INADDR_ANY，这样协议栈会在所有已加入组播组的接口上分发数据。只针对特定接口接收时，才绑定具体 IP，同时IP_ADD_MEMBERSHIP里也要写对应的imr_interface。这里有个记忆技巧：bind管的是本地收包「谁可以找过来」，IP_ADD_MEMBERSHIP管的是「你要参与的组播会话在哪条链路上」。
6. 二次开发技巧：把收发程序改造成可配置的组播调试助手
6.1 用配置文件管理地址、端口、网卡与报文内容
把硬编码地址抽到配置文件里是二次开发最开始要做的事。我一般会做一个简单的config.ini，格式用键值对，避免引入第三方解析库：
[multicast] address=239.255.0.100 port=45678 ttl=16 local_ip=192.168.1.100 interval_ms=1000 message_template=HELLO_MCAST seq=%d time=%lu程序启动时逐行读入，把local_ip设置生效。这里有个坑：Windows 下GetPrivateProfileString可以快速读取 ini，但它要求文件编码固定在 ANSI，如果你在 VS 工程里用 UTF-8 保存配置文件，会读到乱码。我更喜欢自己写一个简单的解析函数，按行读取、按=切分，兼容 UTF-8 不带 BOM。
改造后，发送端变成一个可配置的探测工具，组播地址改成224.0.0.251就等于顺便探测 mDNS 流量，改成239.255.255.250就能和 SSDP 服务通信。这个自由度比每次都改代码重新编译强太多。
6.2 增加报文收发日志与统计
调试组播程序时，最需要的是统计指标：发送总包数、每秒钟包速率、重传次数、接收端收到报文的时间间隔抖动。我在接收端加了三个全局计数器：
volatile long long totalPackets = 0; volatile long long lastSecondPackets = 0; volatile long long lastSecondTimestamp = 0;每次recvfrom成功后在主循环里更新totalPackets，然后另起一个线程每秒计算一次吞吐量并打印：
while (1) { Sleep(1000); long long now = GetTickCount64(); double rate = (now - lastSecondTimestamp > 0) ? lastSecondPackets * 1000.0 / (now - lastSecondTimestamp) : 0.0; printf("throughput: %.2f pkt/s, total=%lld\n", rate, totalPackets); lastSecondPackets = 0; lastSecondTimestamp = now; }同时把报文内容和来源 IP 写入日志文件，按天滚动。这样你在现场调设备时，只需要把运行日志拿来，就能确认是组播包根本没有到达本机，还是到达了但应用层处理太慢。
6.3 扩展思路：多线程接收与定时器发送
如果要把这个程序当长期运行的组播网关，就不能让发送端和接收端各跑各的控制台了。我建议合并成一个进程，内部开两个线程：接收线程负责recvfrom并将数据推入环形队列，主线程负责处理业务逻辑并把响应组播回去。这样就需要考虑套接字的线程安全性。
Winsock 的套接字句柄在同一个进程内跨线程使用，操作系统的同步由内核保证，但你自己得保证不要同时对一个句柄调用closesocket。我在做类似改动时的习惯是：接收线程独占recvfrom，发送线程独占sendto，共享数据用锁或原子变量来保护。
如果要做定时发送，可以用timeSetEvent或者CreateTimerQueueTimer，回调里调sendto不能阻塞太久，因为回调线程是系统线程，阻塞会影响整个进程的定时精度。实测下来 1 毫秒到 10 毫秒级别的组播定时发送，这个方案都稳定。
最后分享一下我的教训：当年调一台嵌入式设备的组播发现协议，怎么改 IP 都收不到，折腾一整天才发现是设备网络上有两台机器绑定了相同的组播地址，导致某台机器频繁发起 IGMP 离开请求，把我的接收端踢出了组播组。从那以后我每次调试组播，都会先抓包看 IGMP 报文，再确认发送端和接收端都加入了同一个组播组，避免在地址和端口上反复碰运气。这组收发程序就是我日常排查问题的基础工具，希望你也能通过它跑通自己的组播链路。
本文还有配套的精品资源，点击获取
