Bluez 5.66下bluetoothctl无法发现BLE设备服务的排查求助

一、先确认bluetoothctl的正确操作流程 #

很多时候问题出在操作步骤遗漏，而非Bluez本身故障：

• 连接BLE设备后，必须手动触发GATT服务发现，bluetoothctl不会自动执行该操作：
  1. 进入GATT专属菜单：menu gatt
  2. 发起服务发现请求：discover-services
  3. 查看所有已发现的服务与特征：list-attributes
• 也可直接在主菜单执行命令，无需切换菜单：

  gatt discover-services 53:4E:48:00:00:0C
  gatt list-attributes 53:4E:48:00:00:0C
  

二、排查Bluez配置与系统设置 #

1. 检查蓝牙核心配置文件：
   编辑/etc/bluetooth/main.conf，确认：
   • EnableGatt = true（默认开启，可再次验证）
   • 将Privacy = auto改为Privacy = off（部分BLE设备对隐私策略敏感）
     修改后重启蓝牙服务：sudo systemctl restart bluetooth
2. 验证蓝牙适配器状态：

   sudo bluetoothctl show
   

   确保Powered: yes、Pairable: yes，Discoverable可设为no（BLE连接无需设备可被发现）

三、通过btmon日志定位交互问题 #

重点查看连接后的ATT层数据包交互：

• 搜索Read By Group Type Request：确认Bluez是否发送了服务发现请求
• 检查设备响应：若设备返回服务条目但bluetoothctl未显示，大概率是前端工具解析bug；若设备无响应，需调整连接参数
• 尝试增大MTU：部分设备需要更大的MTU才能返回完整服务列表，连接后执行：

  mtu 517
  

  重新触发服务发现后再尝试查看

四、绕开bluetoothctl，直接调用DBus接口验证 #

bluetoothctl只是Bluez的前端工具，可能存在兼容性问题，直接调用底层DBus接口测试：

1. 找到设备的DBus路径（将MAC地址的冒号替换为下划线）：

   busctl tree org.bluez | grep 53_4E_48_00_00_0C
   

   会得到类似/org/bluez/hci0/dev_53_4E_48_00_00_0C的路径
2. 触发服务发现：

   dbus-send --system --print-reply --dest=org.bluez /org/bluez/hci0/dev_53_4E_48_00_00_0C org.bluez.GattManager1.DiscoverServices
   

3. 查询已发现的服务列表：

   busctl get-property org.bluez /org/bluez/hci0/dev_53_4E_48_00_00_0C org.bluez.Device1 Services
   

若DBus能正常返回服务列表，说明问题出在bluetoothctl，可尝试升级Bluez版本或改用其他工具。

五、查看已连接设备服务/特征的常用命令 #

bluetoothctl 命令集 #

# 连接目标设备
bluetoothctl connect 53:4E:48:00:00:0C
# 进入GATT菜单
bluetoothctl menu gatt
# 发起服务发现
bluetoothctl discover-services
# 列出所有服务与特征
bluetoothctl list-attributes
# 查看特定特征的详细属性（替换为实际特征路径）
bluetoothctl attribute-info /org/bluez/hci0/dev_53_4E_48_00_00_0C/service000c/char000d

gatttool 命令（需先安装bluez-tools） #

# 进入交互模式连接设备
gatttool -b 53:4E:48:00:00:0C -I
# 发现主服务
> primary
# 列出所有特征
> characteristics

DBus 底层命令 #

# 获取设备已发现的服务列表
busctl get-property org.bluez /org/bluez/hci0/dev_53_4E_48_00_00_0C org.bluez.Device1 Services
# 查看某个服务下的所有特征（替换为实际服务路径）
busctl tree org.bluez /org/bluez/hci0/dev_53_4E_48_00_00_0C/service000c

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