Linux下使用evdev读取双游戏手柄出现重复输入事件问题

问题 #

我正在为引擎开发输入系统，当前调试游戏手柄输入功能，使用第三方Xbox手柄和PS4手柄测试。单独读取任一手柄输入均正常，但同时连接双手柄时出现异常：若先读取Xbox手柄再读PS4手柄，按下Xbox按键会触发两次控制台打印；调换读取顺序后，按下PS4按键会触发两次打印。经调试怀疑手柄事件出现镜像。

我通过open()打开/dev/input/by-id下的设备文件并存储，每帧循环读取处理input_event，代码如下：

struct input_event e;
for (i32 i = 0; i < 2; ++i)
{
    if(state.Gamepads[i] <= 0) { continue; }
    read(state.Gamepads[i], &e, sizeof(e));

    if (e.type == EV_KEY && e.value == 1)
    {
        switch (e.code)
        {
            case BTN_WEST:
            LOG_INFO("BUTTON WEST PRESSED");
            break;
         }
     }
}

我期望双手柄输入独立唯一，但实际出现重复输入。作为Linux开发新手，难以找到相关文档，请问该问题是bug还是实现错误？

原因与解决方法 #

这是实现错误，不是Linux输入子系统的bug，问题根源主要有两点：

1. 可能重复打开了同一手柄的多个设备节点 #

很多游戏手柄（尤其是第三方或Xbox/PS系列）会被Linux识别出多个/dev/input设备节点——比如一个负责按键/摇杆输入，另一个负责LED、震动或其他辅助功能。如果你不小心给同一个手柄打开了多个节点，同一次按键事件会被多个文件描述符读取到，自然会触发多次打印。

2. 未正确处理read()的返回值与事件读取逻辑 #

你的代码存在两个关键疏漏：

• 没检查read()的返回值：如果read()返回的字节数不等于sizeof(input_event)，要么是没读到完整事件，要么是设备无事件（非阻塞模式下），此时你会继续处理上一次的旧事件数据，导致重复触发。
• 每帧只读取一次事件：如果手柄的事件队列里有多条事件（比如按键按下+松开），或者之前帧的事件没读完，会残留到后续帧重复处理。

具体修复步骤 #

• 确认设备节点唯一性： 执行ls /dev/input/by-id/，找到每个手柄对应的event类节点（名称通常包含event-joystick），确保每个手柄只打开这一个节点，不要误开其他功能节点。
• 以非阻塞模式打开设备： 调用open()时加上O_NONBLOCK标志，避免没有事件时read()阻塞主循环：

  int fd = open("/dev/input/by-id/your-handle-event-node", O_RDONLY | O_NONBLOCK);
  

• 正确处理read()返回值并清空事件队列： 对每个手柄，一帧内循环读取所有待处理事件，直到read()返回EAGAIN（无事件），同时严格校验读取的字节数：

  struct input_event e;
  for (i32 i = 0; i < 2; ++i)
  {
      if(state.Gamepads[i] <= 0) { continue; }
      
      ssize_t bytes_read;
      // 循环读取该手柄所有待处理事件
      while ((bytes_read = read(state.Gamepads[i], &e, sizeof(e))) == sizeof(e))
      {
          if (e.type == EV_KEY && e.value == 1)
          {
              switch (e.code)
              {
                  case BTN_WEST:
                  LOG_INFO("Gamepad %d: BUTTON WEST PRESSED", i); // 加索引区分手柄
                  break;
               }
           }
      }
      
      // 处理读取错误（排除无事件的情况）
      if (bytes_read == -1 && errno != EAGAIN)
      {
          LOG_ERROR("Gamepad %d read failed: %s", i, strerror(errno));
          state.Gamepads[i] = -1; // 标记设备失效
      }
  }
  

• 添加手柄标识： 在日志中加入手柄索引，能直观区分事件来自哪个设备，方便排查重复触发的问题。

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