SSH连接Arch Linux运行kdbg提示qt.qpa.xcb无法连接display错误

问题描述 #

通过SSH连接主机后启动kdbg程序，返回以下错误：

qt.qpa.xcb: could not connect to display 
qt.qpa.plugin: Could not load the Qt platform plugin "xcb" in "" even though it was found.
Failed to create wl_display (No such file or directory)
qt.qpa.plugin: Could not load the Qt platform plugin "wayland" in "" even though it was found.
This application failed to start because no Qt platform plugin could be initialized. Reinstalling the application may fix this problem.

Available platform plugins are: wayland-org.kde.kwin.qpa, eglfs, linuxfb, minimal, minimalegl, offscreen, vnc, wayland-egl, wayland, wayland-xcomposite-egl, wayland-xcomposite-glx, xcb.

当前环境信息：

• 操作系统：Arch Linux
• 桌面环境：运行在X11模式下的KDE Plasma
• 已尝试无效操作：重装qt6-base包、安装qt5-base包、参考公开论坛同类问题方案操作，故障未修复。

故障原因 #

报错信息明确标注Qt平台插件本身已经被找到，加载失败的核心原因是SSH会话没有获取到X11显示服务的访问权限，图形程序无法输出界面，和Qt组件安装完整性无关，因此重装Qt相关包无法解决问题。

修复步骤 #

1. 建立SSH连接时主动开启X11信任转发，不要使用无参数的默认SSH连接，执行如下连接命令：

   ssh -Y <用户名>@<目标主机地址>
   

   相比普通-X参数的转发模式，-Y参数不会对远程图形程序做X11安全限制，适配KDE桌面下的Qt程序运行需求。
2. 检查目标主机SSH服务端配置，打开配置文件/etc/ssh/sshd_config，确认以下配置项未被注释、参数值正确：

   X11Forwarding yes
   X11DisplayOffset 10
   X11UseLocalhost yes
   

   配置修改完成后执行sudo systemctl restart sshd重启SSH服务使配置生效。
3. 成功连接到远程主机后，先校验DISPLAY环境变量是否正常赋值：

   echo $DISPLAY
   

   正常配置下会返回类似localhost:10.0的输出，如果返回空值，手动执行如下命令临时设置环境变量：

   export DISPLAY=localhost:10.0
   

4. 在本地机器的X11终端中执行命令，允许远程主机的图形程序接入本地显示服务：

   xhost +
   

   该配置为临时生效，重启本地X会话后会自动恢复默认权限，需要长期生效可以将命令写入用户目录下的.xprofile文件中。
5. 以上配置完成后，在SSH会话中直接执行kdbg命令即可正常启动程序图形界面。

补充说明：若使用Wayland模式的桌面环境，需要额外安装xwayland兼容包才能支持X11转发，当前X11模式的KDE Plasma环境无需执行该操作。

内容的提问来源于stack exchange，提问作者Семён