本文详解如何通过异常捕获与重连机制，使 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('\r\n')
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 不能热插拔”是一种常见误解。真正的限制在于默认代码缺乏异常韧性，而非库本身不可逾越。通过结构化错误处理与状态管理，你完全可以构建出具备工业级可靠性的串口通信服务——无论设备是即插即用还是远程部署，它都能静默恢复，持续值守。
