Qt D-Bus信号失效提示delivery suspended：遥控车示例ARM A7移植异常

本次开发为适配带信号传递能力的D-Bus交互逻辑，基于Qt官方《D-Bus Remote Controlled Car Example》完成移植，运行环境为搭载Qt 5.12.8的Linux ARM A7平台，已完成两项改造：

• 移除原示例所有HMI交互逻辑，替换为纯文本输出的简化运行流程
• 构建系统从qmake迁移为CMake，要求兼容CMake 3.0以上版本

模块构建逻辑：car、controller两个模块分别通过qdbusxml2cpp生成对应D-Bus服务适配端、接口调用端代码，开启AUTOMOC特性，链接Qt5::Core、Qt5::DBus依赖完成编译。

实际运行异常 #

• car进程可正常响应D-Bus方法调用逻辑，可触发对应信号发送流程
• controller进程无法接收任何来自car的D-Bus信号
• 开启QDBUS_DEBUG=1调试模式排查时，所有信号投递流程均输出QDBusConnectionPrivate(0x75d006d0) delivery is suspended提示

复现步骤 #

1. 设置QDBUS_DEBUG=1环境变量
2. 执行dbus-launch --auto-syntax启动独立会话总线
3. 后台启动car进程，前台启动controller进程
4. 触发accelerate方法调用，car侧逻辑正常、可输出crashed信号发送日志，但D-Bus连接始终提示投递挂起，controller侧无信号接收日志。

1. 确认主线程事件循环启动状态 #

delivery is suspended提示的最常见触发原因为当前进程的Qt主线程事件循环未进入运行状态，QDBus连接会自动将入站消息投递标记为挂起，直到事件循环启动完成。
移除HMI逻辑的改造过程中，很容易遗漏原示例中依赖窗口消息循环驱动D-Bus消息分发的逻辑：

• 若主函数完成初始化后直接退出、或使用自定义死循环/线程阻塞等待替代app.exec()，就会导致QDBus连接始终处于挂起状态，无法从总线上拉取入站信号。
  确认要点：两个进程的主函数在完成D-Bus连接、对象注册、信号回调绑定流程后，必须执行return app.exec();启动主线程事件循环，不能提前退出、不能用非Qt事件循环的逻辑做阻塞等待。

2. 确认会话总线环境变量一致性 #

dbus-launch --auto-syntax的输出为临时会话总线的地址配置指令，如果没有将配置正确注入当前shell环境就启动进程，会导致两个进程连入不同的D-Bus总线，触发连接状态异常。
正确操作流程：

# 启动独立会话总线，将返回的环境变量直接注入当前shell
eval $(dbus-launch --auto-syntax)
# 验证环境变量是否生效
echo $DBUS_SESSION_BUS_ADDRESS
# 启动两个测试进程
./car &
./controller

注意：不要仅打印dbus-launch --auto-syntax的输出就直接启动程序，打印的环境变量不会自动注入当前shell的运行环境。

3. 确认D-Bus连接的激活状态 #

在代码中增加连接状态校验，避免初始化阶段未等连接完成握手就进入等待逻辑：

QDBusConnection conn = QDBusConnection::sessionBus();
if (!conn.isConnected()) {
    qCritical() << "D-Bus连接失败:" << conn.lastError().message();
    return 1;
}

如果连接未完成与总线的握手激活，QDBus内部会自动将投递状态标记为suspended，直到连接建立完成。

4. 确认CMake构建对D-Bus生成代码的适配 #

从qmake迁移到CMake时，需要保证qdbusxml2cpp生成的代码能被AUTOMOC正确处理：

• 生成的适配类头文件需要确保在AUTOMOC的扫描路径内，或补充对应moc文件的引用
• 若生成的接口类未被moc正常处理，会导致信号槽关联逻辑初始化异常，也会触发投递状态错误。

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