XTestFakeButtonEvent在GNOME顶栏失效，无障碍模拟鼠标点击无响应

你开发无障碍应用时使用的核心X11模拟点击实现如下：

Display *display = XOpenDisplay(NULL);
XTestFakeButtonEvent(display, button, true, CurrentTime); // true is 'mouse down'
XFlush(display);
XCloseDisplay(display);

该代码在普通应用窗口上可正常运行，但无法触发GNOME顶部状态栏（承载日期时间、系统功能图标、电源控制菜单的顶部栏）的响应，结合GNOME桌面的底层实现逻辑，具体原因和可行方案整理如下：

• 会话协议隔离：目前绝大多数主流Linux发行版的GNOME默认运行在Wayland会话模式下，上述纯X11代码生成的XTestFakeButtonEvent事件，会被XWayland兼容层完全拦截，仅能作用于运行在XWayland沙盒内的传统X11应用窗口。而GNOME顶部状态栏是Mutter合成器的原生Shell组件，不在X11事件的传输链路覆盖范围内，自然不会响应这类跨协议的模拟事件。
• 输入安全过滤机制：哪怕运行在纯X11会话下，GNOME顶部栏作为承载敏感功能的系统级Shell组件，会默认拦截XTest扩展生成的非可信输入。XTest扩展的设计初衷是用于自动化测试，它生成的事件会携带特殊的扩展标记，和真实硬件输入的事件属性存在明确差异。GNOME Shell为了防止恶意程序绕过用户操作模拟点击系统敏感UI，会直接丢弃这类未经过权限校验的模拟事件；而普通第三方应用窗口没有这套严格的输入校验逻辑，所以这段代码在普通窗口上可以正常运行。
• 权限属性不匹配：XTest生成的模拟事件默认没有携带和真实输入一致的可信权限标记，GNOME Shell的输入处理链路会优先放行来自系统输入栈（libinput）的事件，对没有可信标记的跨客户端模拟输入做优先级过滤，顶部栏作为系统UI的核心区域，过滤优先级远高于普通应用窗口。

• 构建跨会话的输入注入逻辑：不要仅依赖XTest扩展实现模拟点击，在应用启动时先检测当前系统的会话类型：
  • 如果是Wayland会话，通过/dev/uinput创建虚拟输入设备，注入和真实硬件完全同源的鼠标点击事件，这类事件会被Mutter识别为可信输入，不会被顶部栏过滤，可兼容所有GNOME系统组件。
  • 如果是纯X11会话，再回退到原有的XTest实现逻辑。
• 申请合规的无障碍辅助资质：将你的应用通过AT-SPI2（GNOME原生的无障碍辅助技术接口）注册为系统认可的辅助工具，引导用户在系统无障碍设置中完成应用授权。完成授权后，你的应用生成的模拟输入事件会被GNOME Shell加入白名单，不会被顶部栏的安全过滤逻辑拦截，完全符合系统的无障碍设计规范，也不会触发安全软件的告警。
• 开发调试阶段的临时验证方案：在纯X11会话下，可以通过gsettings配置临时关闭Mutter对X11非可信输入的过滤，执行gsettings set org.gnome.mutter x11-input-grab-filtering false即可让XTest生成的事件被顶部栏识别。该配置仅用于开发调试阶段验证逻辑，不建议引导普通用户修改，否则会降低系统输入安全防护能力。

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