Windows11下Python pySerial蓝牙串口可写不可读问题排查

问题场景 #

使用Python pyserial库操作蓝牙COM端口时，能成功发送download命令，设备确认收到并正在发送数据，但脚本始终无法读取到返回内容，ser.read(1)持续返回空字节。用Windows自带串口终端连接同一端口时，收发均正常。

环境信息 #

• Windows 11
• Python 3.10.7
• pyserial 3.5

问题代码 #

import serial

print("serial.VERSION: %s" % (serial.VERSION))
BluetoothSerialPort = 'COM9'
ser = serial.Serial()
ser.timeout = 1.0
ser.baudrate = 115200
ser.parity = 'N'
ser.bytesize = 8
ser.stopbits = 1
ser.port = BluetoothSerialPort
ser.open()

# 启动二进制数据下载
# 此步骤正常，蓝牙设备会回复一行ASCII响应，
# 随后发送10KB的二进制文件数据（非ASCII）
ser.write(b'download')

# packetBytes长度始终为0？？？
downloading = True
while downloading:
    packetBytes = ser.read(1)
    print("packetBytes.: %d" % (len(packetBytes)))

可能原因与解决方法 #

1. 命令缺少终止符

多数串口设备要求命令以换行（\n）或回车换行（\r\n）作为结束标志，否则不会识别为完整命令并响应。Windows终端通常会自动添加终止符，而你的代码直接发送b'download'可能不符合设备要求。

修改发送逻辑：

ser.write(b'download\r\n')  # 优先尝试回车换行，若无效换b'download\n'

2. 硬件流控配置不匹配

蓝牙串口默认通常不需要硬件流控，但pyserial可能默认启用了相关设置，导致设备发送的数据无法被读取。

添加流控禁用配置：

ser = serial.Serial()
# 原有配置不变，新增以下行
ser.rtscts = False
ser.dsrdtr = False
ser.xonxoff = False
ser.dtr = False
ser.rts = False

3. 串口缓冲区残留数据

打开串口后，缓冲区可能存在之前的残留数据，干扰新数据的读取。在打开串口后清空缓冲区：

ser.open()
ser.flushInput()  # 清空输入缓冲区
ser.flushOutput() # 清空输出缓冲区

4. 读取逻辑适配设备响应流程

设备会先返回ASCII响应行，再发送二进制数据，你可以先读取响应行，再批量读取二进制数据，避免逐字节读取的低效和超时问题：

# 发送命令后先读取ASCII响应
response_line = ser.readline().decode('ascii').strip()
print(f"设备响应: {response_line}")

# 读取10KB二进制数据
received_data = b''
while len(received_data) < 10 * 1024:
    chunk = ser.read(1024)
    if not chunk:
        print("数据读取超时，终止")
        break
    received_data += chunk
    print(f"已接收{len(received_data)}字节")

# 处理接收的二进制数据，比如保存到文件
with open('downloaded_data.bin', 'wb') as f:
    f.write(received_data)

5. 核对串口参数一致性

确认Windows终端使用的所有串口参数（波特率、奇偶校验、停止位、流控）与代码完全一致，尤其是流控选项，这是常见的不匹配点。

内容的提问来源于stack exchange，提问作者Ed of the Mountain