ESP32串口连接Python界面出现UTF-8解码错误求助

1. 排查ESP32端的输出内容格式 #

带传感器的ESP32如果直接输出传感器原始二进制数据（比如ADC原始值、寄存器字节），用UTF-8解码必然失败。

• 若输出二进制数据：Python端不要用decode('utf-8')，先读取原始字节再解析：

  # 示例：读取4字节无符号整数（根据传感器输出格式调整字节数和字节序）
  raw_bytes = ser.read(4)
  sensor_val = int.from_bytes(raw_bytes, byteorder='little')
  

• 若要输出字符串：ESP32端需先将传感器数值转为合法UTF-8字符串再输出，避免直接打印二进制内容：

  float sensor_data = get_sensor_value(); // 读取传感器数据
  Serial.println(String(sensor_data)); // 转为字符串后输出
  

2. 处理传输中的乱码与解码异常 #

传感器读取可能占用ESP32资源，导致串口输出不连续或丢包，产生非法UTF-8字节：

• Python端增加错误捕获，跳过无效行：

  try:
      line = ser.readline().decode('utf-8').strip()
  except UnicodeDecodeError:
      continue  # 跳过解码失败的行，继续读取下一条
  

• 确保ESP32与Python端的串口参数完全一致（波特率、奇偶校验等），ESP32初始化串口后可加短暂延迟：

  Serial.begin(115200);
  delay(100); // 等待串口连接稳定
  

3. 用标准化格式传输数据 #

将传感器数据打包为JSON或Base64等格式，避免二进制传输的解码问题：

• ESP32端用JSON封装数据：

  #include <ArduinoJson.h>
  
  StaticJsonDocument<128> doc;
  doc["temp"] = read_temperature();
  doc["humi"] = read_humidity();
  serializeJson(doc, Serial);
  Serial.println(); // 用换行作为数据分隔符
  

• Python端解析JSON：

  import json
  
  try:
      line = ser.readline().decode('utf-8').strip()
      data = json.loads(line)
      temp = data["temp"]
      humi = data["humi"]
  except (UnicodeDecodeError, json.JSONDecodeError):
      continue
  

4. 重新确认pyserial环境 #

虽然之前重装过库，仍可再次排查：

• 卸载旧版本：pip uninstall pyserial
• 安装稳定版本：pip install pyserial==3.5
• Python端打开串口时明确指定所有参数：

  import serial
  ser = serial.Serial(
      port='COM3',  # 替换为实际串口端口
      baudrate=115200,
      timeout=1,
      parity=serial.PARITY_NONE,
      stopbits=serial.STOPBITS_1,
      bytesize=serial.EIGHTBITS
  )
  

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