Ubuntu下root运行QSystemTrayIcon.isSystemTrayAvailable()返回False问题排查

环境：Ubuntu 20.04（搭配Gnome3、X11、Qt5.12.8、PyQt 5.14.1）

执行以下PyQt代码：

from PyQt5.QtWidgets import QSystemTrayIcon, QApplication
qapp = QApplication([''])
print(str(QSystemTrayIcon.isSystemTrayAvailable()))

普通用户执行输出True，但通过sudo或pkexec以root身份执行时输出False。

需解决两个问题：

1. 如何排查root执行时返回False的原因（是否支持开启日志）；
2. 如何让root身份运行的代码也能启用系统托盘图标。

已尝试注入用户的X11环境变量，但无效果：

pkexec env DISPLAY=$DISPLAY XDG_RUNTIME_DIR=$XDG_RUNTIME_DIR XAUTHORITY=$XAUTHORITY python3 -c "from PyQt5.QtWidgets import QSystemTrayIcon, QApplication; qapp = QApplication(['']); print(str(QSystemTrayIcon.isSystemTrayAvailable()))"

补充说明：
相关Qt5核心逻辑：

• QSystemTrayIcon::isSystemTrayAvailable()：内部直接调用平台相关的私有实现
• QSystemTrayIconPrivate::isSystemTrayAvailable_sys()（X11平台）：通过检查X11系统中是否存在符合freedesktop托盘规范的窗口来判断托盘是否可用

问题1：排查root执行返回False的方法 #

开启Qt调试日志 #

Qt支持通过环境变量启用调试日志，针对X11托盘逻辑，设置以下变量后执行root权限命令：

pkexec env QT_LOGGING_RULES="qt.widgets.systemtrayicon.debug=true" DISPLAY=$DISPLAY XDG_RUNTIME_DIR=$XDG_RUNTIME_DIR XAUTHORITY=$XAUTHORITY python3 -c "from PyQt5.QtWidgets import QSystemTrayIcon, QApplication; qapp = QApplication(['']); print(str(QSystemTrayIcon.isSystemTrayAvailable()))"

日志会输出X11托盘探测的细节，比如是否找到托盘窗口、权限问题或协议交互失败的原因。

直接检查X11托盘窗口 #

用xprop工具查看当前X11会话中的托盘窗口：
普通用户执行：

xprop -root _NET_SYSTEM_TRAY_S0

若返回结果说明托盘窗口存在。再用root身份执行同样命令，若无法获取，说明root进程无法访问该X11资源，可能是权限或Xauthority配置问题。

验证X11权限 #

检查root进程能否正常连接X11服务器：

pkexec env DISPLAY=$DISPLAY XAUTHORITY=$XAUTHORITY xeyes

如果xeyes能正常显示，说明X11连接没问题；若不能，说明$XAUTHORITY对应的文件root没有读取权限。

问题2：让root进程启用系统托盘的解决方案 #

修复Xauthority权限 #

默认$XAUTHORITY文件（通常为~/.Xauthority）权限是用户私有（600），root无法读取。可临时修改权限：

chmod 644 ~/.Xauthority

测试完成后改回原权限保证安全：

chmod 600 ~/.Xauthority

使用sudo的-X参数 #

sudo -X会保留当前用户的X11环境，包括正确的XAUTHORITY设置，比手动注入变量更可靠：

sudo -X python3 -c "from PyQt5.QtWidgets import QSystemTrayIcon, QApplication; qapp = QApplication(['']); print(str(QSystemTrayIcon.isSystemTrayAvailable()))"

配置pkexec的X11访问权限 #

pkexec默认严格限制环境变量，需修改策略文件允许传递X11变量。创建或编辑/usr/share/polkit-1/actions/com.example.pyttray.policy：

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE policyconfig PUBLIC
 "-//freedesktop//DTD PolicyKit Policy Configuration 1.0//EN"
 "http://www.freedesktop.org/standards/PolicyKit/1/policyconfig.dtd">
<policyconfig>
  <action id="com.example.pyttray">
    <description>Run PyQt tray as root</description>
    <message>Authentication is required to run the PyQt tray application as root</message>
    <defaults>
      <allow_any>auth_admin</allow_any>
      <allow_inactive>auth_admin</allow_inactive>
      <allow_active>auth_admin</allow_active>
    </defaults>
    <annotate key="org.freedesktop.policykit.exec.path">/usr/bin/python3</annotate>
    <annotate key="org.freedesktop.policykit.exec.allow_gui">true</annotate>
  </action>
</policyconfig>

使用以下命令执行：

pkexec --user root com.example.pyttray -c "from PyQt5.QtWidgets import QSystemTrayIcon, QApplication; qapp = QApplication(['']); print(str(QSystemTrayIcon.isSystemTrayAvailable()))"

org.freedesktop.policykit.exec.allow_gui设为true会允许pkexec传递必要的X11环境变量。

底层原因说明 #

X11平台下Qt判断托盘可用的逻辑是：读取root窗口上的_NET_SYSTEM_TRAY_S0属性，获取对应托盘窗口ID。root进程若无法访问当前用户的X11会话资源（如XAUTHORITY权限不足），就无法读取这些属性，因此返回False。

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