pyserial连接Arduino控制舵机运行30秒报WriteFile failed权限错误

报错本质是串口通信过程中Arduino设备异常复位/串口驱动拒绝IO，由三个代码缺陷直接导致：

• 传输数据无帧边界：Python端只发送纯数字字节，不带结束标记，Arduino的Serial.parseInt()无法判断单次角度数据是否传输完成，容易把多次发送的数字拼接错误、或等待数据超时。长时间运行后Arduino仅64字节的串口接收缓冲区会被无效数据塞满，触发USB串口驱动异常，导致设备短暂离线。
• Arduino端代码存在阻塞问题：嵌套的while(Serial.available())循环配合默认1秒超时的parseInt()，碰到不完整数据就会卡住主循环，触发Arduino内置看门狗强制复位。复位过程中串口会短暂断开，Python端持有的旧串口句柄直接失效，写入数据就会抛出权限错误。
• Python端只写数据不清理缓冲区：打开串口后仅执行写入操作，从不读取返回数据、也不主动刷新发送缓冲区，Windows系统下常用的CH340、CP2102串口芯片驱动，在单侧缓冲区堆积到阈值时会直接拒绝IO请求，返回“设备不识别命令”的错误。
  *额外硬件诱因：如果舵机直接从Arduino板载5V引脚取电，转动时的电流尖峰会拉低主板电压，导致Arduino随机掉电重启，也会触发同类报错。

1. 调整Arduino端代码 #

改为非阻塞读取逻辑，设置合理串口超时，增加数据校验和缓冲区清理逻辑，避免阻塞和数据堆积：

#include <Servo.h>

Servo servo;
const int MIN_ANGLE = 0;
const int MAX_ANGLE = 180;

void setup() {
  servo.attach(9);
  Serial.begin(9600);
  Serial.setTimeout(50); // 设置parseInt超时为50ms，避免长时间阻塞主循环
}

void loop() {
  if (Serial.available() > 0) {
    int pos = Serial.parseInt();
    // 仅处理合法范围的角度值
    if (pos >= MIN_ANGLE && pos <= MAX_ANGLE) {
      servo.write(pos);
    }
    // 读取完成后清空缓冲区残留的无效数据
    while(Serial.available() > 0) {
      Serial.read();
    }
  }
  delay(10); // 短延时避免主循环空跑，降低看门狗触发概率
}

2. 调整Python端代码 #

增加帧分隔符、上电等待、缓冲区刷新逻辑，从根源避免缓冲区溢出：

import serial
import time

# 打开串口后等待2秒，等Arduino上电复位完成再通信
port = serial.Serial('COM3', 9600, timeout=1)
time.sleep(2)

while port.isOpen():
    try:
        int_data = int(input("Enter servo position (0-180): "))
        if 0 <= int_data <= 180:
            # 数据末尾加换行符作为帧结束标识，解决粘包问题
            byte_data = f"{int_data}\n".encode()
            port.write(byte_data)
            port.flush() # 强制将缓冲区数据全部发出，避免堆积
        else:
            print("Invalid value, please enter number between 0 and 180")
    except PermissionError:
        print("Serial reset detected, reconnecting...")
        port.close()
        time.sleep(1)
        try:
            port.open()
            time.sleep(2)
        except:
            pass
    except ValueError:
        print("Please enter valid integer")
    except Exception as e:
        print(f"Fatal error: {e}")
        break

port.close()

3. 硬件排查 #

• 舵机工作电流较大，不要直接使用Arduino板载5V引脚供电，单独为舵机配备5V/2A以上的电源，舵机电源地必须和Arduino地连接共地。
• 检查USB线是否存在接触不良、线阻过大问题，优先使用带屏蔽层的短USB线连接Arduino。

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