树莓派BlueZ GATT服务器：如何用bluetoothctl更新本地特征值？

开发者阿泽

2026-5-14

解决方案

你遇到的select-attribute自动补全不显示本地GATT服务/特征的问题，在BlueZ 5.x版本的bluetoothctl里挺常见的，主要和上下文切换、DBus路径识别有关，下面给你几个针对性的解决办法：

先确保处于正确的蓝牙适配器上下文
默认情况下bluetoothctl可能没自动选中你的树莓派蓝牙适配器，先执行：
```
select-adapter hci0
```
（如果你的适配器不是hci0，可以用list-adapters查看），切换后再尝试list-attributes，应该能看到你创建的GATT服务和特征列表了。
手动指定特征的完整DBus路径（绕过自动补全）
如果自动补全还是失效，直接用list-attributes命令列出所有可用的GATT属性，找到你要更新的特征的完整路径（比如/org/bluez/hci0/service000a/char000b），然后直接执行：
```
select-attribute /org/bluez/hci0/service000a/char000b
```
这样就能选中目标特征，不需要依赖自动补全功能。
确认GATT特征的Notify权限配置正确
先检查你的特征是否开启了Notify权限，执行以下命令查看特征的Flags：
```
busctl get-property org.bluez /org/bluez/hci0/service000a/char000b org.bluez.GattCharacteristic1 Flags
```
返回结果里必须包含"notify"，如果没有，你需要重新创建特征时添加该权限（比如在创建特征的命令里加上notify flag）。
更新特征值并触发Notify的正确流程
选中特征后，用write-value命令写入新值（注意用十六进制格式），比如：
```
write-value 00010203
```
只要客户端已经订阅了该特征的Notify，就能立即收到更新后的数值。
重启蓝牙服务重置状态
如果以上方法都无效，试试重启BlueZ服务来重置蓝牙状态：
```
sudo systemctl restart bluetooth
```
然后重新搭建你的GATT服务器，再重复前面的操作步骤。