使用Boost ASIO通过串口收发二进制数据的问题排查

问题现象 #

• 正在实现C++（基于Boost ASIO v1.82.0）与ESP32的串口通信协议，协议采用1字节头部标识数据类别，后跟变长字节数组（用于编码整数、浮点数）
• ESP32端经二进制终端测试表现正常，但C++端调用同步写入方法发送二进制数据时，始终触发**"The handle is invalid"**错误
• 已反复确认波特率等端口配置正确，尝试过字节数组指针、vector<char>、std::string等多种数据传递方式，均触发相同错误
• 不确定读取数据时的转换逻辑是否为发送转换的逆操作

现有实现代码 #

#include <boost/asio.hpp>
#include <iostream>
#include <string>

using namespace boost;
using namespace std;

class SerialInterface {
private:
    asio::io_context io_context;
    asio::serial_port serialPort{io_context};

public:
    bool begin(const char* port, long baudRate) {
        try {
            serialPort.open(port);
            serialPort.set_option(asio::serial_port_base::baud_rate(baudRate));
            serialPort.set_option(asio::serial_port_base::character_size(8));
            serialPort.set_option(asio::serial_port_base::parity(asio::serial_port_base::parity::none));
            serialPort.set_option(asio::serial_port_base::stop_bits(asio::serial_port_base::stop_bits::one));
            serialPort.set_option(asio::serial_port_base::flow_control(asio::serial_port_base::flow_control::none));
        }
        catch (boost::system::system_error& e) {
            cerr << "Error opening serial port: " << e.what() << endl;
            return false;
        }
        return true;
    }

    void sendByte(uint8_t data) {
        try {
            if (serialPort.is_open()) {
                uint8_t bytes[1] = { data };
                string buffer(reinterpret_cast<char*>(bytes), 1);
                asio::write(serialPort, asio::buffer(buffer, 1));
            }
        }
        catch (system::system_error& e) {
            std::cerr << "Exception: " << e.what() << std::endl;
        }
    }

    uint8_t readByte() {
        if (!serialPort.is_open()) {
            return 0;
        }

        uint8_t buffer[1];
        system::error_code error;

        try {
            size_t bytes_read = asio::read(serialPort, boost::asio::buffer(buffer, 1), error);
            if (error || bytes_read == 0) {
                return 0;
            }
        }
        catch (system::system_error& e) {
            std::cerr << "Exception: " << e.what() << std::endl;
            return 0;
        }

        return buffer[0];
    }
};

问题排查与修复建议 #

1. "The handle is invalid"错误根源 #

该错误核心是串口句柄无效，常见触发原因：

• io_context生命周期异常：Boost ASIO的serial_port依赖io_context，如果io_context被提前销毁或未保持全局/成员级生命周期，会直接导致句柄失效。
• 串口被其他进程占用：即使终端测试正常，也要确保C++程序运行时，终端已关闭，串口未被独占。
• 端口路径格式错误：Windows下端口为"COMx"，Linux下为"/dev/ttyUSBx"，需确认路径格式符合系统要求。

2. 代码修复点 #

• 固定io_context生命周期：将io_context作为SerialInterface的成员变量，确保在整个串口通信过程中保持有效。
• 简化发送逻辑：无需将uint8_t转换为std::string，直接用asio::buffer包装字节数组即可，避免不必要的类型转换：

  void sendByte(uint8_t data) {
      try {
          if (serialPort.is_open()) {
              asio::write(serialPort, asio::buffer(&data, sizeof(data)));
          }
      }
      catch (system::system_error& e) {
          std::cerr << "Exception: " << e.what() << std::endl;
      }
  }
  

• 读取逻辑验证：读取时直接从uint8_t缓冲区获取数据即可，发送操作只是将原始字节写入串口，读取操作直接读取原始字节，两者完全对称，不存在转换逆操作的问题。

3. 额外验证步骤 #

• 发送前再次用serialPort.is_open()确认端口状态，避免因意外关闭导致的句柄无效。
• Windows下以管理员权限运行程序，Linux下将用户加入dialout组，排除权限不足导致的句柄错误。

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