Linux下以root身份运行PyQt6程序遇xcb插件初始化错误求助

问题场景 #

尝试在Linux系统中通过pkexec切换到root身份运行PyQt6应用，代码如下：

import os
import sys
from PyQt6.QtWidgets import QApplication

from gui.gui import MainUI


if __name__ == '__main__':
    if os.getuid() != 0:
        args = ['pkexec'] + [sys.executable] + sys.argv
        os.execlp(args[0], *args)
    else:
        app = QApplication([])
        gui = MainUI()
        gui.show()
        app.exec()

运行时触发Qt平台插件初始化错误：

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.
This application failed to start because no Qt platform plugin could be initialized. Reinstalling the application may fix this problem.

Available platform plugins are: offscreen, minimal, minimalegl, linuxfb, eglfs, wayland, vnc, wayland-egl, xcb, vkkhrdisplay.

原因分析 #

pkexec默认不会继承当前普通用户的DISPLAY和XAUTHORITY环境变量：

• DISPLAY指定Qt需要连接的X服务器显示设备
• XAUTHORITY存储X服务器的认证信息，用于验证进程是否有权限访问显示设备

root进程缺少这两个变量，导致Qt无法连接X服务器，进而触发xcb插件初始化失败。

解决方法 #

方法1：让pkexec保留关键环境变量 #

修改代码中调用pkexec的参数，明确指定保留DISPLAY和XAUTHORITY变量：

import os
import sys
from PyQt6.QtWidgets import QApplication

from gui.gui import MainUI


if __name__ == '__main__':
    if os.getuid() != 0:
        # 添加参数让pkexec保留DISPLAY和XAUTHORITY环境变量
        args = [
            'pkexec',
            '--keep-cwd',
            '--environment=DISPLAY',
            '--environment=XAUTHORITY',
            sys.executable
        ] + sys.argv
        os.execlp(args[0], *args)
    else:
        app = QApplication([])
        gui = MainUI()
        gui.show()
        app.exec()

方法2：替换为sudo运行 #

sudo默认会自动继承DISPLAY等与X服务器相关的环境变量（前提是sudo配置未修改相关默认设置），直接将pkexec替换为sudo即可：

import os
import sys
from PyQt6.QtWidgets import QApplication

from gui.gui import MainUI


if __name__ == '__main__':
    if os.getuid() != 0:
        args = ['sudo', sys.executable] + sys.argv
        os.execlp(args[0], *args)
    else:
        app = QApplication([])
        gui = MainUI()
        gui.show()
        app.exec()

方法3：手动配置root用户的X认证信息 #

如果前两种方法不适用，可以手动将当前用户的X认证信息复制给root：

1. 运行以下命令复制.xauth文件：

sudo cp ~/.Xauthority /root/.Xauthority
sudo chown root:root /root/.Xauthority

2. 确保root进程能读取该文件，之后再运行你的PyQt6应用。

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