本文详解如何通过异常捕获与重连机制，使 pyserial 脚本在 usb 串口设备（如 pl2303）热插拔时保持稳定运行，避免因设备断开导致程序崩溃，并支持自动恢复通信。
本文详解如何通过异常捕获与重连机制，使 pyserial 脚本在 usb 串口设备（如 pl2303）热插拔时保持稳定运行，避免因设备断开导致程序崩溃，并支持自动恢复通信。
在 windows 平台使用 PySerial（如 v3.5+）与基于 PL2303、CH340、CP2102 等芯片的 USB-to-Serial 设备通信时，一个常见痛点是：物理拔掉设备后，ser.in_waiting 或 ser.readline() 等操作会触发 SerialException（底层 WinAPI ClearCommError 失败），导致主循环中断甚至进程退出。这与 PuTTY 等终端工具行为一致，但并不意味着无法实现“热插拔友好”的鲁棒设计。
关键在于——PySerial 本身不内置热插拔支持，但完全可通过 Python 的异常处理机制模拟该能力。其核心思路是：将所有串口 I/O 操作包裹在 try 块中；一旦捕获到串口异常（如设备断开、句柄失效），立即尝试关闭旧实例并重建新连接，而非让程序终止。
以下是一个生产就绪的改进版本，已验证在 Windows 10 + PySerial 3.5+ + PL2303 场景下稳定工作：
import time import serial import logging # 可选：启用日志便于调试 logging.basicConfig(level=logging.INFO) logger = logging.getLogger(__name__) SERIAL_PORT = "COM10" BAUDRATE = 9600 TIMEOUT = 0.5 ser = None def open_serial(): """安全打开串口，失败时返回 None""" try: return serial.Serial(SERIAL_PORT, BAUDRATE, timeout=TIMEOUT) except (serial.SerialException, OSError) as e: logger.warning(f"Failed to open {SERIAL_PORT}: {e}") return None # 初始连接（支持启动时设备未插入） ser = open_serial() if ser is None: logger.info(f"Serial device not found on {SERIAL_PORT}. Waiting for connection...") while True: try: # 仅当串口已建立时才读取 if ser and ser.is_open and ser.in_waiting > 0: raw_data = ser.readline() if raw_data: try: decoded = raw_data.decode('ascii').rstrip('rn') print(f"Received: {decoded}") except UnicodeDecodeError: print(f"Received binary data (len={len(raw_data)}): {raw_data.hex()}") except (serial.SerialException, OSError, ValueError) as e: # 设备断开、I/O 错误、解码异常等均在此统一处理 logger.error(f"Serial error occurred: {e}") if ser: try: ser.close() except: pass ser = None # 重置状态 # 尝试重连（仅当当前未连接时） if ser is None: logger.info("Attempting to reconnect...") ser = open_serial() if ser: logger.info(f"Reconnected to {SERIAL_PORT}") time.sleep(0.01) # 防止空转占用过高 CPU✅ 该方案优势显著：
- ✅ 支持启动时设备未接入：首次 open_serial() 失败不会中断程序；
- ✅ 支持运行中热拔插：拔掉 → 自动关闭旧连接 → 持续轮询 → 插入 → 自动重连；
- ✅ 兼容多种异常类型：不仅涵盖 SerialException，也捕获底层 OSError（如 Windows 错误 995）和 UnicodeDecodeError；
- ✅ 资源安全：确保 ser.close() 被调用，避免句柄泄漏；
- ✅ 可扩展性强：可轻松集成设备枚举（如 serial.tools.list_ports.grep）实现端口自动发现。
⚠️ 注意事项：
- 不要对 except: 使用裸异常捕获（如原答案中的 except:），它会吞掉 KeyboardInterrupt（Ctrl+C）等关键信号，导致无法优雅退出；
- 若需支持多端口或自动端口识别（例如 Arduino 插在不同 COMx），建议结合 serial.tools.list_ports.comports() 动态筛选 VID/PID；
- 在 linux/macos 上，类似逻辑同样适用，但错误类型略有差异（如 OSError: [errno 5] input/output error），建议统一捕获 serial.SerialException 和 OSError；
- 对于高实时性场景，可将 time.sleep(0.01) 替换为更精细的事件等待（如 select.select 配合非阻塞模式），但对大多数传感器/按钮类设备，当前策略已足够高效。
总结而言，“PySerial 不能热插拔”是一种常见误解。真正的限制在于默认代码缺乏异常韧性，而非库本身不可逾越。通过结构化错误处理与状态管理，你完全可以构建出具备工业级可靠性的串口通信服务——无论设备是即插即用还是远程部署，它都能静默恢复，持续值守。