Ubuntu 20.04下node-global-key-listener监听失效问题求助

你的场景是node-global-key-listener在Windows、Mac正常运行，但Ubuntu 20.04中X11子进程已初始化但stdout.on('data')事件未触发，可按以下步骤排查：

1. 检查X11依赖与权限 #

• 验证系统是否安装X11开发依赖：

  dpkg -l | grep libx11-dev
  dpkg -l | grep libxtst-dev
  

  若未安装，执行：

  sudo apt-get install libx11-dev libxtst-dev
  

• 确认当前用户X11访问权限：
  运行xauth list查看是否包含当前DISPLAY（通常是:0）的授权记录。若缺失，可临时执行xhost +开放权限（仅测试用，生产环境需用xauth配置正确授权），同时确保Node子进程启动时继承DISPLAY环境变量，可显式指定：

  const proc = spawn('./x11-server-binary', [], {
    env: { ...process.env, DISPLAY: process.env.DISPLAY }
  });
  

2. 直接测试X11子进程二进制 #

找到node-global-key-listener包中对应的X11子进程二进制文件（一般在build或bin目录下），直接在终端运行。敲击键盘后观察是否有输出：

• 若有输出：说明CPP逻辑正常，问题出在Node层的stdout监听。检查子进程启动时的stdio配置是否为['pipe', 'pipe', 'pipe']（默认是，但可显式指定避免异常）。
• 若无输出：说明CPP的X11事件捕获逻辑存在问题，继续下一步排查。

3. 监听子进程错误输出 #

你目前只监听了stdout，子进程可能在stderr输出了关键错误信息。添加stderr监听：

this.proc.stderr.on("data", data => {
    console.error("X11子进程错误日志:", data.toString());
});

运行后查看是否有权限不足、X11连接失败或依赖缺失的提示，这通常是问题根源。

4. 排查CPP层X11事件逻辑（基础操作无需深入CPP） #

如果直接运行二进制无输出，可在CPP代码中添加基础日志输出到stderr：

• 检查XOpenDisplay(NULL)的返回值是否为NULL（若为NULL则X11连接失败），添加日志：

  Display* dpy = XOpenDisplay(NULL);
  if (!dpy) {
      fprintf(stderr, "Failed to open X11 display\n");
      return 1;
  }
  

• 确认是否正确注册键盘事件：检查XSelectInput是否传入了KeyPressMask | KeyReleaseMask，且根窗口是否正确获取（DefaultRootWindow(dpy)）：

  Window root = DefaultRootWindow(dpy);
  XSelectInput(dpy, root, KeyPressMask | KeyReleaseMask);
  

重新编译二进制后再次测试，查看stderr输出的日志。

5. 排除桌面环境快捷键拦截 #

Ubuntu的GNOME等桌面环境可能会拦截部分全局快捷键，导致X11子进程无法捕获。先测试普通字母、数字键，看是否能触发输出，排除快捷键冲突的可能。

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