使用pkexec运行X应用时XOpenDisplay返回NULL问题排查求助

问题根源 #

pkexec默认的环境变量白名单不包含X11图形应用必需的DISPLAY和XAUTHORITY变量，即使配置了allow_gui注解，部分发行版（比如Ubuntu、Debian系）的polkit版本也不会自动传递这两个变量，导致root权限的应用无法连接当前用户的X服务，XOpenDisplay返回0。

解决方法 #

方法1：启动命令手动传递环境变量 #

运行应用时显式指定两个变量，无需修改系统配置，临时测试最方便：

pkexec env DISPLAY=$DISPLAY XAUTHORITY=$XAUTHORITY /usr/local/bin/app

方法2：修改polkit配置永久允许环境变量传递 #

编辑/etc/polkit-1/localauthority.conf.d/50-localauthority.conf（无该文件则新建），将两个变量加入环境变量白名单：

[Configuration]
AdminIdentities=unix-user:0
Environment=DISPLAY XAUTHORITY

修改后重启polkit服务生效：

sudo systemctl restart polkit

方法3：应用代码兼容处理 #

你自己开发的应用可以主动读取配置，避免依赖环境变量传递：

• 从/run/user/[当前登录用户UID]/gdm/Xauthority路径读取X授权文件
• 单用户图形会话场景可直接固定DISPLAY值为:0

额外检查项 #

• 确认polkit策略文件权限为644，所属用户组为root:root，否则polkit不会加载该策略
• 部分polkit版本对布尔值大小写敏感，可尝试将策略中org.freedesktop.policykit.exec.allow_gui的值改为小写true
• 执行pkla-check-authorization可以验证你的自定义策略是否正常加载

内容的提问来源于stack exchange，提问作者Fantastic Mr. Fox