Docker容器内Pyjoystick无法识别Xbox One控制器问题排查

你遇到的问题是Docker特权容器内xow能正常配对Xbox One控制器，但基于SDL2的Pyjoystick无法检测到设备，而主机运行正常。核心原因大概率是容器内SDL2无法访问输入设备或依赖缺失，以下是具体排查和解决步骤：

1. 检查输入设备是否被容器映射 #

xow会在主机的/dev/input目录下创建虚拟游戏手柄设备（通常是jsX或eventX格式），特权模式不代表自动映射所有/dev下的设备：

• 进入容器，执行 ls /dev/input，查看是否存在对应手柄的设备文件。
• 如果没有，启动容器时添加挂载参数：

  docker run --privileged -v /dev/input:/dev/input ...
  

2. 补充SDL2依赖库 #

容器默认可能缺少SDL2的核心依赖或输入相关组件，导致无法枚举设备：

• Debian/Ubuntu系容器执行：

  apt update && apt install -y libsdl2-2.0-0 libsdl2-dev sdl2-jstest
  

• 验证SDL2是否正常：执行 sdl2-jstest --list，如果能列出Xbox控制器，说明SDL2已正常识别。

3. 验证Pyjoystick的适配性 #

如果SDL2能检测到设备但Pyjoystick不行：

• 确认Pyjoystick是基于SDL2的版本，并且安装正确：

  pip uninstall pyjoystick && pip install pyjoystick[sdl2]
  

• 修正测试脚本的缺失回调（原脚本未定义print_remove和key_received，可能导致无输出）：

  from pyjoystick.sdl2 import Joystick, run_event_loop
  
  def print_add(joy):
      print('Added', joy)
  
  def print_remove(joy):
      print('Removed', joy)
  
  def key_received(key):
      print('Key', key)
  
  run_event_loop(print_add, print_remove, key_received)
  

4. 检查udev规则（可选） #

SDL2依赖udev来识别输入设备，容器内如果没有运行udev服务，可能需要手动触发设备事件：

• 启动容器时添加挂载：

  docker run --privileged -v /dev/input:/dev/input -v /run/udev:/run/udev ...
  

• 进入容器后执行 udevadm trigger 刷新设备列表。

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