树莓派3B开机自启含Pynput的Python脚本时出现平台不支持错误

pynput的键盘控制模块依赖X11桌面会话，而rc.local或普通开机sh脚本是在桌面环境启动前、以无桌面会话的上下文运行的，此时DISPLAY环境变量未设置，也没有可用的X连接，导致无法初始化pynput的后端，抛出平台不支持的错误。

方法1：使用桌面自启动项（推荐，适配树莓派桌面环境） #

树莓派官方桌面环境支持用户级自启动，会在用户登录桌面后自动执行，此时DISPLAY变量已正确配置：

• 创建自启动配置文件：

  nano ~/.config/autostart/keyboard-script.desktop
  

• 写入以下内容（替换脚本路径为你的实际路径）：

  [Desktop Entry]
  Type=Application
  Name=KeyboardControlScript
  Exec=python3 /home/pi/controlsAndServer.py
  Hidden=false
  NoDisplay=false
  X-GNOME-Autostart-enabled=true
  

• 保存退出（按Ctrl+O，回车，Ctrl+X），重启系统即可生效。

方法2：修改rc.local，手动配置DISPLAY变量 #

如果必须用rc.local启动，需要手动指定DISPLAY并切换到普通用户（避免root权限的X会话问题）：

• 编辑rc.local：

  sudo nano /etc/rc.local
  

• 在exit 0之前添加以下命令（注意加&让脚本后台运行，防止阻塞开机流程）：

  su - pi -c "export DISPLAY=:0 && python3 /home/pi/controlsAndServer.py &"
  

• 保存后重启系统。如果仍报错，可能需要添加X授权：

  su - pi -c "export DISPLAY=:0 && xauth merge ~pi/.Xauthority && python3 /home/pi/controlsAndServer.py &"
  

方法3：确认X11服务状态 #

确保树莓派已启用桌面环境：

• 执行sudo raspi-config，进入System Options -> Boot / Auto Login，选择Desktop Autologin，保存后重启，确保开机自动登录桌面。

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