Python实现BLE外设报No valid service object found错误排查

1 验证DBus对象路径层级合规性 #

BlueZ要求GATT应用的所有对象必须遵循严格的层级结构：

• 应用根对象路径示例：/org/bluez/custom_gatt_app
• 服务对象必须是应用根对象的子节点：/org/bluez/custom_gatt_app/service0
• 特征、描述符必须对应为上级服务、特征的子节点
  可通过以下命令递归验证所有对象的暴露状态：

gdbus introspect --system --dest [你的程序总线名] --object-path [应用根对象路径] --recurse

如果服务对象没有挂载在应用根路径下，BlueZ扫描时会无法识别。

2 校验GattService1属性格式合法性 #

• UUID必须为标准128位字符串格式，16位/32位UUID需要补全蓝牙BASE UUID：例如16位0xFFE0需写为0000ffe0-0000-1000-8000-00805f9b34fb，禁止直接传递整数/字节类型的UUID值
• Primary属性必须为布尔类型，不能用数字1/0代替
  用以下命令单独校验属性值和类型：

# 校验UUID
dbus-send --system --print-reply --dest=[你的程序总线名] [服务对象路径] org.freedesktop.DBus.Properties.Get string:org.bluez.GattService1 string:UUID
# 校验Primary属性
dbus-send --system --print-reply --dest=[你的程序总线名] [服务对象路径] org.freedesktop.DBus.Properties.Get string:org.bluez.GattService1 string:Primary

3 检查BlueZ运行配置与权限 #

• 确认bluetoothd已开启实验特性：执行ps aux | grep bluetoothd，查看进程参数是否包含--experimental，GATT外设注册功能默认需开启该参数，未开启需修改bluetooth.service配置后重启蓝牙服务
• 确认运行程序的用户有DBus操作权限：默认只有root用户可调用GattManager1的RegisterApplication接口，普通用户运行可先加sudo测试，长期使用可配置polkit规则放开权限
• 确认BlueZ版本≥5.50，旧版本存在GATT注册相关的已知兼容性问题

4 排查注册时序问题 #

必须等所有GATT对象（应用、服务、特征、描述符）全部完成DBus总线暴露后，再调用RegisterApplication接口。如果异步注册对象未完成就发起注册请求，会导致BlueZ扫描时找不到服务对象。

• 提取syslog中bluetoothd打印的无法读取的UUID值，和代码中定义的UUID逐位对比，确认是否存在大小写错误、短横线缺失、位数不对的问题，建议统一使用小写带短横线的标准UUID格式
• 测试阶段优先使用自定义随机生成的128位UUID，避免使用蓝牙SIG预留的16位官方UUID段，部分预留UUID如果未实现规范要求的必填属性会被BlueZ拒绝注册
• 确认UUID属性的访问权限为可读，bluetoothd需要主动读取该属性，设置为只写会导致读取失败

直接运行BlueZ官方源码中test/example-gatt-server示例程序，若示例可正常注册服务，说明系统环境无问题，可对比示例的DBus对象结构、属性定义、注册时序和你的代码差异，快速定位问题。

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