运行donkey calibrate命令时出现OSError: [Errno 121]远程IO错误求助

嘿，我之前在DonkeyCar v2.2.1版本上运行donkey calibrate时也碰到过类似的IO错误，给你几个实用的排查和解决方向，应该能帮到你：

• 检查硬件连接与系统权限
  IO错误最常见的诱因是硬件没接稳，或者当前用户缺少访问硬件设备的权限：

  • 先确认方向盘、电机控制器等外设都牢固连接，重启树莓派后再重试命令。
  • 将当前用户加入dialout（串口权限）和gpio（GPIO权限）组：

    sudo usermod -aG dialout $USER
    sudo usermod -aG gpio $USER
    

  • 登出并重新登录系统，让权限变更生效。

• 验证项目配置与文件权限
  donkey calibrate需要读取项目的配置文件，路径错误或权限不足也会触发IO问题：

  • 确保在你的DonkeyCar项目目录下执行命令，或者用--path参数指定正确路径：

    donkey calibrate --path /home/pi/my_doncar_project
    

  • 检查项目目录下config.py等文件的权限，确保当前用户有读写权限：

    ls -l /home/pi/my_doncar_project
    

  • 若权限异常，执行以下命令修复：

    sudo chown -R $USER:$USER /home/pi/my_doncar_project
    

• 获取完整错误日志定位根源
  你提供的Traceback被截断了，完整的错误信息会明确指出是哪个文件/设备访问失败：

  • 重新运行命令并保存完整日志：

    donkey calibrate 2>&1 | tee calibrate_error.log
    

  • 查看日志末尾的具体错误类型（比如PermissionError、FileNotFoundError），这能直接锁定问题核心。

• 调整依赖版本适配环境
  DonkeyCar v2.2.1的部分依赖可能与你的系统环境不兼容，导致IO操作失败：

  • 检查虚拟环境中关键依赖的版本：

    pip list | grep -E "pyserial|RPi.GPIO"
    

  • 若使用树莓派，尝试降级pyserial到3.5版本（这个版本在老款树莓派上兼容性更好）：

    pip install pyserial==3.5
    

  • 如果硬件支持，也可以考虑升级DonkeyCar到最新稳定版：

    pip install --upgrade donkeycar
    

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