QT 5.10.1串口无法发送数据，原因何在？

DevOps 小满

2026-5-27

排查串口发送无数据但无报错的问题

这种无报错但接收端收不到数据的情况确实挺头疼的，我帮你梳理几个常见的排查方向，按优先级试试应该能定位到问题：

先确认串口参数完全匹配：接收端和你的发送端必须在波特率、数据位、停止位、奇偶校验这几个参数上完全一致。比如你代码里如果硬编码了波特率9600，接收端要是设成115200，那肯定收不到任何内容。建议在代码里显式配置这些参数，并且和接收端的配置逐一核对。
检查串口是否真的成功打开并就绪：虽然程序没报错，但QSerialPort::open()返回成功不代表硬件层面完全就绪。比如用真实USB-RS232的话，你可以在终端跑dmesg | grep ttyUSB0看看系统有没有正确识别设备；再用stty -F /dev/ttyUSB0查看当前串口的实际参数，确认和你代码里设置的一致。
强制刷新发送缓冲区：Qt的串口类有时候会把数据暂存在缓冲区里，不会立即发送。试试在调用write()之后马上调用flush()，强制把缓冲区里的数据推出去：
```
serial->write(yourData);
serial->flush();
```
排查VirtualBox管道的特殊配置：用/dev/Winsock这种管道的话，VirtualBox的串口设置必须完全正确：要选“Host Pipe”模式，勾选“Create pipe”选项，而且主机和虚拟机的管道名称要完全匹配。另外还要检查管道文件的读写权限，确保root用户能正常访问。
验证发送逻辑的有效性：在write()之后打印返回值，看看实际发送了多少字节，比如：
```
qint64 bytesSent = serial->write(yourData);
qDebug() << "实际发送字节数：" << bytesSent;
```
如果返回0，说明根本没有数据被发送出去，得检查你要发送的数据是否为空，或者串口是否处于正常的打开状态。
用工具验证硬件/链路可用性：比如真实USB-RS232的话，用minicom或者screen这类工具手动发送数据，看看接收端能不能收到。如果工具能发成功，那问题肯定出在你的代码里；如果工具也发不了，那可能是硬件故障（比如线缆损坏、接收端设备未通电）。

监听隐藏的串口错误：有时候一些非致命错误不会导致程序崩溃，但会影响数据发送。建议在代码里加上错误信号的监听，捕获可能被忽略的问题：

connect(serial, &QSerialPort::errorOccurred, [this](QSerialPort::SerialPortError error) {
    if (error != QSerialPort::NoError) {
        qDebug() << "串口错误：" << serial->errorString();
    }
});

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