云计算百科
云计算领域专业知识百科平台

【Qt】系统相关:UDP 回显服务器

/* MD / 富文本中的 .toc(含博客园搬家等嵌套结构);.toc-box 在侧栏,不受影响 */
#content_views .toc,
/* 编辑器常在目录前后插入空 p(:empty 仍占 20px),一并去掉避免顶空隙 */
#content_views.markdown_views > p:empty:has(+ .toc),
#content_views.markdown_views > .toc + p:empty,
/* 富文本旧版目录标记 */
#content_views.htmledit_views #main-toc,
#content_views.htmledit_views #hr-toc,
#content_views.htmledit_views p[id*=\”-toc\”] {
display: none !important;
}
/* 目录去掉后,紧跟的首个标题不再多出一块上边距 */
#content_views.markdown_views > .toc + h1,
#content_views.markdown_views > .toc + h2,
#content_views.markdown_views > .toc + h3,
#content_views.markdown_views > .toc + h4,
#content_views.markdown_views > .toc + p:empty + h1,
#content_views.markdown_views > .toc + p:empty + h2,
#content_views.markdown_views > .toc + p:empty + h3,
#content_views.markdown_views > .toc + p:empty + h4 {
margin-top: 0 !important;
}

头像

🎬 个人主页:艾莉丝努力练剑

❄专栏传送门:《C语言》《数据结构与算法》《C/C++干货分享&学习过程记录》 《Linux操作系统编程详解》《笔试/面试常见算法:从基础到进阶》《Python干货分享》

⭐️为天地立心,为生民立命,为往圣继绝学,为万世开太平


🎬 艾莉丝的简介:

在这里插入图片描述


文章目录

  • 1 ~> Qt UDP Socket 基础概念
    • 1.1 UDP 核心特性
      • 1.1.1 报文概念区分
      • 1.1.2 TCP 与 UDP 传输模型对比
    • 1.2 Qt UDP 核心类
      • 1.2.1 QUdpSocket
      • 1.2.2 QNetworkDatagram
    • 1.3 端口号规范
  • 2 ~> Qt UDP 回显服务器开发流程
    • 2.0 项目前置配置
      • 2.0.1 pro 项目文件配置
      • 2.0.2 UI 界面设计
    • 2.1 头文件 widget.h
    • 2.2 源文件 widget.cpp
    • 2.3 核心开发要点
      • 2.3.1 QUdpSocket 对象内存管理
      • 2.3.2 bind 绑定失败判断
      • 2.3.3 processRequest 处理流程
      • 2.3.4 QNetworkDatagram 发送要点
  • 3 ~> 易错考点与面试重点
    • 3.1 概念考点
    • 3.2 代码坑点
    • 3.3 对比原生 Linux socket
  • 结尾

在这里插入图片描述


1 ~> Qt UDP Socket 基础概念

1.1 UDP 核心特性

1.1.1 报文概念区分

  • Packet(数据包):通用网络术语,指网络层(IP)的传输单元,TCP、UDP、IP 的数据单元均可泛称为数据包。
  • Datagram(数据报):特指无连接、自包含、可独立路由的分组,即 IP 数据报与 UDP 数据报。
  • 关键性质:每个数据报独立寻址与处理,协议栈不保证到达、不保证顺序、丢包不重传,可靠性需由应用层自行实现。

考试与面试的标准表述: 1、UDP 是面向数据报(datagram-oriented) 的协议; 2、TCP 是面向字节流(byte-stream-oriented) 的协议。

1.1.2 TCP 与 UDP 传输模型对比

  • UDP:应用层交付多长的数据,UDP 就将其封装为一个 UDP 数据报交给 IP 层,内核不做应用层消息的拆分与合并;超过路径 MTU 时由 IP 层分片。无连接、无流量控制、无拥塞控制。收发操作以完整数据报为单位,一次接收对应一次发送。
  • TCP:字节流模型,不存在数据报边界。应用写入的字节被视为连续字节流,内核自动完成分段(MSS 切分)与重组,因此存在应用层需自行处理的“粘包/拆包”问题。

1.2 Qt UDP 核心类

1.2.1 QUdpSocket

QUdpSocket 封装 UDP 套接字描述符,基于 Qt 信号槽机制实现事件驱动 I/O,默认走非阻塞模型。

API / 信号功能对应原生 Linux API
bind(QHostAddress, quint16) 绑定本地 IP 与端口,服务端使用 bind()
receiveDatagram() 读取一个完整 UDP 数据报,返回 QNetworkDatagram recvfrom()
writeDatagram(const QNetworkDatagram&) 发送一个完整 UDP 数据报 sendto()
readyRead 信号 内核接收缓冲区出现数据时触发,是事件驱动入口 无,等价于 I/O 多路复用就绪通知
  • 原生 recvfrom/sendto 默认为阻塞 I/O:无数据时线程挂起等待,会阻塞整个线程的执行流。
  • Qt 的实现路径:不使用阻塞调用,依靠 readyRead 信号,在数据到达后触发槽函数,从而完成事件驱动网络编程。

1.2.2 QNetworkDatagram

QNetworkDatagram 表示一个完整 UDP 数据报,封装载荷数据、源/目的 IP 与源/目的端口。

API功能原生 API 对标
QNetworkDatagram(QByteArray, QHostAddress, quint16) 构造待发送数据报,携带载荷、目标 IP、目标端口 无
data() 获取报文载荷,返回 QByteArray 无
senderAddress() 获取收到报文的对端源 IP recvfrom 输出参数
senderPort() 获取收到报文的对端源端口 recvfrom 输出参数

1.3 端口号规范

端口号为 16 位无符号整数,取值范围 0–65535,按 IANA 划分为四段。

  • 0 端口:保留值,bind 传入 0 表示由内核自动分配一个可用临时端口;服务端不得将其作为对外公布的服务端口。
  • 知名端口 1–1023:特权端口,Linux 下绑定需 root 权限或 CAP_NET_BIND_SERVICE;由系统标准服务占用(22 SSH、80 HTTP)。
  • 注册端口 1024–49151:普通业务程序可直接绑定使用。
  • 动态/私有端口 49152–65535:IANA 建议的临时端口区间,客户端由内核自动分配源端口;服务端不宜绑定该区间。Linux 实际的临时端口范围由 /proc/sys/net/ipv4/ip_local_port_range 决定,默认通常为 32768–60999。
  • 约束:同一 四元组(协议、本地 IP、本地端口、对端 IP、对端端口)在未设置 SO_REUSEADDR/SO_REUSEPORT 时,同一本地端口同一时刻仅允许一个套接字独占绑定。


    2 ~> Qt UDP 回显服务器开发流程

    2.0 项目前置配置

    2.0.1 pro 项目文件配置

    必须引入 network 模块,否则编译器无法定位 QUdpSocket 头文件。

    QT += core gui widgets network

    • 引入模块后仍提示找不到头文件:执行 qmake 重新解析 .pro,触发工程重新构建。

    2.0.2 UI 界面设计

    • 主窗口使用 QWidget,日志区使用 QListWidget 控件,逐条追加通信记录。

    2.1 头文件 widget.h

    #ifndef WIDGET_H
    #define WIDGET_H

    #include <QWidget>
    #include <QUdpSocket>
    #include <QNetworkDatagram>

    QT_BEGIN_NAMESPACE
    namespace Ui { class Widget; }
    QT_END_NAMESPACE

    class Widget : public QWidget
    {
    Q_OBJECT
    public:
    Widget(QWidget *parent = nullptr);
    ~Widget();

    private:
    Ui::Widget *ui;
    QUdpSocket* socket; // UDP 套接字对象

    // 处理 UDP 收到数据的槽函数
    void processRequest();
    // 业务处理函数:回显业务直接返回原始请求字符串
    QString process(const QString& request);
    };
    #endif // WIDGET_H

    2.2 源文件 widget.cpp

    关键逻辑顺序:必须先 connect 信号槽,再调用 bind 绑定端口。若顺序颠倒,bind 成功后客户端立即发来的数据报到达时槽函数尚未挂载,报文虽在缓冲区中但可能被后续逻辑覆盖或漏处理,形成竞态。

    #include "widget.h"
    #include "ui_widget.h"
    #include <QMessageBox>

    Widget::Widget(QWidget *parent)
    : QWidget(parent)
    , ui(new Ui::Widget)
    {
    ui->setupUi(this);
    this->setWindowTitle("UDP 回显服务器");

    // 创建 QUdpSocket 实例:指定 this 为父对象,纳入 Qt 对象树,窗口析构时自动释放,无需手动 delete
    socket = new QUdpSocket(this);

    // 先挂载信号槽,再执行 bind,避免绑定完成后首批报文无人处理
    connect(socket, &QUdpSocket::readyRead,
    this, &Widget::processRequest);

    // bind:QHostAddress::Any 表示绑定本机全部网卡地址
    bool ret = socket->bind(QHostAddress::Any, 9090);
    if (!ret)
    {
    // bind 失败时弹出错误提示;errorString() 封装系统错误码的可读描述,等价于 perror 的输出
    QMessageBox::critical(this, "服务器启动出错", socket->errorString());
    return;
    }
    }

    Widget::~Widget()
    {
    delete ui;
    // socket 的父对象为 this,由对象树自动回收,此处不得重复 delete
    }

    // 请求处理槽函数:服务器标准流程为「读取请求 → 业务计算响应 → 写回响应」
    void Widget::processRequest()
    {
    // 1. 读取一个完整 UDP 数据报
    const QNetworkDatagram requestDatagram = socket->receiveDatagram();

    // 取出载荷字节数组,转换为业务层字符串
    QString request = requestDatagram.data();

    // 2. 业务逻辑处理:回显服务器,响应与请求内容一致
    QString response = process(request);

    // 3. 构造响应报文:载荷 + 客户端源 IP + 客户端源端口,回写给发送方
    QNetworkDatagram responseDatagram(response.toUtf8(),
    requestDatagram.senderAddress(),
    requestDatagram.senderPort());
    // 发送响应数据报
    socket->writeDatagram(responseDatagram);

    // 组装交互日志,追加到 QListWidget
    QString log = QString("[%1:%2] req:%3, resp:%4")
    .arg(requestDatagram.senderAddress().toString())
    .arg(requestDatagram.senderPort())
    .arg(request)
    .arg(response);
    ui->listWidget->addItem(log);
    }

    // 业务处理函数:真实项目在此实现完整业务逻辑
    QString Widget::process(const QString &request)
    {
    // 回显服务器直接返回原始请求
    return request;
    }

    2.3 核心开发要点

    2.3.1 QUdpSocket 对象内存管理

  • 构造时传入 this 父指针:对象加入 Qt 对象树,窗口析构时自动释放,无需手动 delete。
  • 不传入父指针:析构函数中必须手动 delete socket,否则造成内存泄漏。
  • 2.3.2 bind 绑定失败判断

    • bind 返回 bool,false 表示绑定失败。
    • 常见诱因:端口被占用、权限不足(绑定 1023 以下端口)、地址非法或被防火墙策略拦截。
    • socket->errorString() 返回可读错误描述,是对操作系统 errno 的封装。

    2.3.3 processRequest 处理流程

  • 读取请求报文;
  • 执行业务逻辑计算响应;
  • 将响应写回客户端;
  • 更新界面日志输出。
  • UDP 回显业务的响应内容与请求内容完全一致; 生产环境服务器在第 2 步会承载复杂的业务计算。

    2.3.4 QNetworkDatagram 发送要点

    发送响应报文时必须指定对端 IP 地址与对端端口,二者从收到的 requestDatagram 经 senderAddress()、senderPort() 取得,不可使用本机地址或固定端口。


    3 ~> 易错考点与面试重点

    3.1 概念考点

  • UDP 面向数据报:一次 receiveDatagram 读取一个完整 UDP 报文,不存在半包与粘包;TCP 面向字节流,存在粘包需应用层定界。
  • readyRead 触发时机:内核套接字接收缓冲区收到数据;槽函数内部调用 receiveDatagram 取走报文。
  • bind 顺序:必须先连接信号槽,后执行 bind;bind 之后端口即对外可用,若槽未连接会形成报文处理缺口。
  • QHostAddress::Any:绑定本机全部网卡地址,可接收来自任一网卡到达该端口的数据。
  • 3.2 代码坑点

  • 忘记在 .pro 中添加 network 模块,编译期找不到 QUdpSocket 头文件。
  • 发送数据报未填写目标 IP 与目标端口,报文无法确定目的地址。
  • 混淆 QTcpSocket 与 QUdpSocket:UDP 无连接建立过程;QUdpSocket 的 connectToHost 仅是设置默认目的地址,不执行三次握手。
  • 服务端绑定到动态端口区间(49152–65535),易与客户端临时端口抢占,应优先使用注册端口区间(1024–49151)。
  • 3.3 对比原生 Linux socket

    Qt UDP APILinux 原生 socket API差异
    QUdpSocket + readyRead 信号 socket() + bind() + recvfrom()/sendto() Qt 为事件驱动非阻塞;原生默认阻塞 I/O,需 select/poll/epoll 实现多路复用
    receiveDatagram() recvfrom() Qt 直接返回封装好的数据报对象并带出源地址;recvfrom 通过输出参数回填源地址
    writeDatagram() sendto() Qt 传入 QNetworkDatagram 对象;sendto 传入缓冲区、长度与 sockaddr 结构体

    结尾

    uu们,本文的内容到这里就全部结束了,艾莉丝在这里再次感谢您的阅读!

    艾莉丝努力练剑

    C/C++ & Linux 底层探索者 | 一个正在努力练剑的技术博主


    👀
    【关注】 跟随我一起深耕技术领域,见证每一次成长。

    ❤️
    【点赞】 让优质内容被更多人看见,让知识传递更有力量。

    ⭐
    【收藏】 把核心知识点存好,在需要时随时查、随时用。

    💬
    【评论】 分享你的经验或疑问,评论区一起交流避坑!

    不要忘记给博主“一键四连”哦!

    “今日练剑达成!”

    “技术之路难免有困惑,但同行的人会让前进更有方向。”

    结语:希望对学习Linux相关内容的uu有所帮助,不要忘记给博主“一键四连”哦!

    往期回顾:

    【QT】系统相关:Qt网络编程概述

    🗡博主在这里放了一只小狗,大家看完了摸摸小狗放松一下吧!🗡

    ૮₍ ˶ ˊ ᴥ ˋ˶₎ა

    在这里插入图片描述

    赞(0)
    未经允许不得转载:网硕互联帮助中心 » 【Qt】系统相关:UDP 回显服务器
    分享到: 更多 (0)

    评论 抢沙发

    评论前必须登录!