当前位置：首页 > news >正文

QUdpSocket的readyRead信号触发时机解析

news 2026/5/12 15:52:53

1.QUdpSocket的readyRead信号发送的时机

QUdpSocket的readyRead()信号是在有新的 UDP 数据报到达套接字的接收缓冲区，并且应用程序尚未读取这些数据时发出的。

具体来说，其触发时机如下：

✅ 触发条件

UDP 数据报已到达本地主机并被操作系统接收；
该数据报已被放入QUdpSocket的内部接收缓冲区中；
当前没有正在进行的readDatagram()（或类似读取操作），即事件循环处于空闲状态；
事件循环正在运行（例如调用了QApplication::exec()或QEventLoop::exec()），因为readyRead()是通过 Qt 的事件系统异步发出的。

⚠️ 注意事项

readyRead()不会为每个数据报单独触发一次。如果多个数据报在事件循环处理前到达，它们会堆积在缓冲区中，readyRead()只触发一次，你需要在槽函数中循环读取所有可用的数据报，直到pendingDatagramSize() == -1。
示例：
```
void onReadyRead() { while (udpSocket->hasPendingDatagram()) { QByteArray datagram; datagram.resize(udpSocket->pendingDatagramSize()); udpSocket->readDatagram(datagram.data(), datagram.size()); // 处理 datagram } }
```
如果你在readyRead()信号的槽函数中没有读完所有数据，不会再发出新的readyRead()信号，直到下一批新数据到来（因为 Qt 认为已有未处理的数据，无需重复通知）。
readyRead()是一个“提示”信号，表示“现在可以无阻塞地读取数据”，不是“每来一个包就通知一次”。
UDP 是无连接、不可靠协议，数据报可能丢失、乱序或重复，但readyRead()只关心“有没有可读的数据”，不保证完整性或顺序。

🔄 与 TCP (`QTcpSocket`) 的区别

QTcpSocket::readyRead()表示有字节流可读，而QUdpSocket::readyRead()表示有完整数据报可读。
UDP 的每次readDatagram()读取的是一个完整的数据报，不会出现“半包”问题（但可能因缓冲区太小而截断）。

总结

QUdpSocket::readyRead()在至少有一个完整的 UDP 数据报已到达且尚未被读取，并且事件循环有机会处理 I/O 事件时被触发。

确保在槽函数中用while(hasPendingDatagram())循环读取全部数据，避免遗漏。

2.readDatagram接口每次读取的是一个包吗

是的，QUdpSocket::readDatagram()每次调用读取的是一个完整的 UDP 数据报（即一个“包”）。

✅ 核心行为说明：

UDP 是面向数据报（datagram-oriented）的协议，每个发送操作（如writeDatagram()）对应一个独立的数据报。
接收端每次调用readDatagram()会原子地读取一个完整的数据报，不会出现“半包”或“粘包”（这是与 TCP 的关键区别）。
即使你传入的缓冲区比实际数据报大，也只会读取当前这一个数据报的内容；如果缓冲区太小，则多余部分会被丢弃（UDP 不支持截断后保留剩余数据）。

📌 函数原型

qint64 readDatagram(char *data, qint64 maxSize, QHostAddress *address = nullptr, quint16 *port = nullptr);

data：用于存放接收到的数据报内容。
maxSize：缓冲区大小。必须 ≥ 当前待读数据报的实际大小，否则数据会被截断（且无法恢复）。
可选参数address和port可获取发送方的地址和端口。

🔍 如何确保不丢数据？

先查询待读数据报的大小：
```
qint64 size = udpSocket->pendingDatagramSize();
```
这个值就是下一个完整 UDP 包的字节数。

分配足够缓冲区再读取：

QByteArray datagram; datagram.resize(udpSocket->pendingDatagramSize()); udpSocket->readDatagram(datagram.data(), datagram.size(), &sender, &senderPort);

循环读取所有待处理数据报（因为readyRead()可能对应多个包）：
```
while (udpSocket->hasPendingDatagram()) { // 读取一个完整包 }
```

⚠️ 注意事项

UDP 数据报最大理论长度为 65507 字节（IPv4 下：65535 - IP头20 - UDP头8），但实际受网络 MTU 限制（通常 ≤ 1500 字节）。若应用可能收大包，需确保缓冲区足够。
如果maxSize < pendingDatagramSize()，超出部分会被静默丢弃，且无法得知是否发生截断（除非你对比readDatagram()返回值与pendingDatagramSize()）。
每次readDatagram()调用只消耗接收队列中的一个数据报。