如何让systemd守护进程运行DBus服务？PyQt5通信报错排查

我用Python写了PyQt5程序和一个守护进程，两者通过DBus通信——PyQt5程序执行以下命令发送指令：

dbus-send --session --dest="org.example.dirswatcher" --type="method_call" --print-reply "/" "org.example.dirswatcher.update_dirs_to_watch"

触发守护进程里的update_dirs_to_watch方法。测试阶段一切正常，但把dirswatcherd.py配置成systemd守护进程后，运行PyQt5程序时出现报错：

Error org.freedesktop.DBus.Error.ServiceUnknown: The name org.example.dirswatcher was not provided by any .service files

守护进程状态有时显示“activating”，偶尔修改.service或.conf文件后状态正常，但DBus服务始终无法正常提供。

已完成的配置：

1. DBus配置文件/etc/dbus-1/system.d/org.example.dirswatcher.conf：

<!DOCTYPE busconfig PUBLIC "-//freedesktop//DTD D-Bus Bus Configuration 1.0//EN" "http://www.freedesktop.org/standards/dbus/1.0/busconfig.dtd">
<busconfig>
  <policy context="default">
    <allow own="org.example.dirswatcher"/>
    <allow send_destination="org.example.dirswatcher"/>
    <allow receive_sender="org.example.dirswatcher"/>
  </policy>
</busconfig>

2. systemd服务文件/etc/systemd/system/dirswatcher.service：

[Unit]
Description=Dirs watcher
After=network.target

[Service]
User=omen
ExecStart=/usr/bin/python3 /home/user/file-manager/daemon/dirswatcherd.py
Restart=always

[Install]
WantedBy=multi-user.target

守护进程代码片段：

class Service(QDBusAbstractAdaptor, QObject):
    Q_CLASSINFO('D-Bus Interface', 'org.exmaple.dirswatcher')

    def __init__(self, parent):
        super().__init__(parent)
        QDBusConnection.sessionBus().registerObject("/", parent)

        if not QDBusConnection.sessionBus().registerService("org.exmaple.dirswatcher"):
            print(QDBusConnection.sessionBus().lastError().message())
...

问题排查与修复步骤 #

1. 修正DBus接口名称拼写错误 #

代码里的org.exmaple.dirswatcher存在拼写错误，exmaple应为example，和命令里的org.example.dirswatcher完全一致。拼写不匹配会直接导致DBus无法识别服务。

2. 区分Session Bus和System Bus #

当前配置存在总线类型混淆：

• 发送命令用的是--session（会话总线），但DBus配置文件放在了系统总线的配置目录/etc/dbus-1/systemd/；
• systemd系统级守护进程默认没有用户会话总线的环境变量，调用sessionBus()无法正常连接到用户会话总线。

两种解决方式：

方式A：改用System Bus

• 修改守护进程代码，替换总线类型：

  # 替换原sessionBus()为systemBus()
  QDBusConnection.systemBus().registerObject("/", parent)
  if not QDBusConnection.systemBus().registerService("org.example.dirswatcher"):
      print(QDBusConnection.systemBus().lastError().message())
  

• 发送命令时去掉--session，改用系统总线：

  dbus-send --system --dest="org.example.dirswatcher" --type="method_call" --print-reply "/" "org.example.dirswatcher.update_dirs_to_watch"
  

• 保持现有DBus配置文件位置不变（/etc/dbus-1/systemd/）

方式B：将systemd服务改为用户级服务

• 把服务文件移到用户配置目录：~/.config/systemd/user/dirswatcher.service
• 修改服务文件[Install]段：

  WantedBy=default.target
  

• 使用用户级命令管理服务：

  systemctl --user enable dirswatcher.service
  systemctl --user start dirswatcher.service
  

• 此时守护进程运行在用户会话中，可正常访问会话总线，DBus配置文件可移到~/.dbus/session.d/org.example.dirswatcher.conf，或保留系统级配置并确保权限允许。

3. 检查systemd服务启动日志 #

查看详细日志定位激活失败原因：

journalctl -u dirswatcher.service -f

若服务卡在activating，大概率是启动时依赖缺失（如Qt DBus模块初始化失败）或代码存在阻塞操作导致服务无法完成启动。

4. 补充必要的环境变量 #

systemd系统级服务默认环境变量极少，Qt程序可能需要DISPLAY、XDG_RUNTIME_DIR等变量，可在服务文件[Service]段添加：

Environment="DISPLAY=:0"
Environment="XDG_RUNTIME_DIR=/run/user/$(id -u omen)"

5. 验证DBus服务注册状态 #

服务启动后，检查目标总线上的服务列表：

• 系统总线：

  dbus-send --system --type=method_call --print-reply --dest=org.freedesktop.DBus /org/freedesktop/DBus org.freedesktop.DBus.ListNames
  

• 会话总线：

  dbus-send --session --type=method_call --print-reply --dest=org.freedesktop.DBus /org/freedesktop/DBus org.freedesktop.DBus.ListNames
  

搜索org.example.dirswatcher是否在返回列表中。

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