GSettings(一）——Root 权限的服务调用Gsetting失效

错误描述

当在 root 权限下拉起的服务中，调用 Gsetting 设置 key，无法实现持久化，并且命令行查看 key 并没有设置成功，命令行运行会输出如下警告：

(process:183768): dconf-WARNING **: 10:55:36.400: failed to commit changes to dconf: Cannot autolaunch D-Bus without X11 $DISPLAY

错误分析

Root 服务设置 Gsetting key Demo：

#include <QCoreApplication>
#include <QDBusConnection>
#include <QDBusInterface>
#include <QDBusError>
#include <QDebug>
#include <QProcessEnvironment>
#include <QGSettings/QGSettings>class TestObject : public QObject
{Q_OBJECT
public:TestObject() {registerSystemDBus();setGsetting();}void registerSystemDBus(){QDBusConnection systemBus = QDBusConnection::systemBus();if (!systemBus.isConnected()) {qDebug() << "Failed to connect to system bus:" << systemBus.lastError().message();return;}if (!systemBus.registerService("com.example.TestSystemdService")) {qDebug() << "Failed to register service:" << systemBus.lastError().message();return;}if (!systemBus.registerObject("/com/example/TestObject",this,QDBusConnection::ExportAllSlots)) {qDebug() << "Failed to register object:" << systemBus.lastError().message();return;}}void setGsetting(){QGSettings *m_gsettings = nullptr;const QString schemaId = "com.redflag.datetime";if (m_gsettings) {qDebug() << "QGSettings already initialized.";return;}if (QGSettings::isSchemaInstalled(schemaId.toUtf8().constData())) {qDebug() << "QGSettings initialized for schema: " << schemaId;m_gsettings = new QGSettings(schemaId.toUtf8().constData(), nullptr);} else {qDebug() << "Schema not installed: " << schemaId;}m_gsettings->set("timeformat", "12 小时");delete m_gsettings;}public slots:void testMethod() {qDebug() << "testMethod called";}
};int main(int argc, char *argv[])
{QCoreApplication a(argc, argv);TestObject testObject;return a.exec();
}#include "main.moc"

运行以上程序（需注意 System DBus 需要在 root 用户下执行），会发现当在 root 拉起的服务中，调用 Gsetting 设置 key 会发现设置失败，key 并没有变化；此时命令行输出为

(process:183768): dconf-WARNING **: 10:55:36.400: failed to commit changes to dconf: Cannot autolaunch D-Bus without X11 $DISPLAY，这个错误通常出现在尝试在没有图形界面的环境中使用 D-Bus 或 GSettings 时。这是因为这些配置工具依赖于会话总线，而会话总线通常需要在图形界面下运行。

此处没有图形界面的环境的意思：

以 root 用户身份运行程序，但 root 用户未配置或访问到普通用户的图形会话，例如，普通用户在桌面环境中启动了会话总线，但 root 用户在纯命令行环境中运行命令；（demo运行场景）
没有启动桌面环境，只有命令行界面；
或者服务器、远程终端、嵌入式系统等。
没有 DISPLAY 变量，因为没有图形显示。

总结

GSettings 通过 GObject 库与 D-Bus 进行通信，将配置请求发送到 DConf 后端，由 DConf 后端实际存储和管理配置数据。而无法正确连接到 D-Bus 会话总线，就会无法设置 GSettings 的 key。因为 D-Bus 会话总线是 GSettings 操作的基础，如果无法连接，就无法进行设置。