树莓派4 C++开发BlueZ BLE时DBus内省结果异常排查

在树莓派4（RPI4）上基于BlueZ开展Bluetooth LE开发时，参考官方《Bluetooth® Technology for Linux Developers》指南做C++等效实现卡在广播步骤的场景下，可直接排除DBus环境损坏、DBus存在隐藏接口机制两类误判，异常内省结果的根因来自指南配套示例本身的不规范实现：

• 接口名注册错误：指南配套的server_advertising.py示例实现org.bluez.LEAdvertisement1接口逻辑时，错误将接口名注册为org.bluez.LEAdvertisingManager1。和BlueZ官方Git仓库维护的标准example-advertisement示例对比，二者运行时除内省显示的接口名存在差异外，实际功能表现完全一致，这就是d-feet内省看不到预期org.bluez.LEAdvertisement1接口的直接原因。
• 属性实现不符合DBus规范：上述两个Python示例均未按DBus接口规范标准注册属性，仅重写了GetAll方法直接返回程序内部维护的属性值，这种非标准实现会导致d-feet等内省工具无法枚举到接口下的属性列表，并非属性缺失或工具故障。

调试提示：该场景下DBus内省结果无法作为有效的调试参考，编写C++广播实现时无需对照Python示例的内省结果做校验，直接以BlueZ官方发布的org.bluez.LEAdvertisement1接口文档为依据，核对接口名、方法/属性签名、返回值合规性即可，可通过bluetoothctl或第三方BLE扫描App验证广播是否实际生效。

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