UWP连接小米手环2遇ProtocolError与ArgumentNullException问题排查

阿华AIGC实验室

2026-5-25

排查小米手环2 UWP获取步数的ArgumentNullException/ProtocolError问题

我来帮你梳理下这个问题——之前折腾过小米手环的BLE通信，踩过不少类似的坑，应该能帮到你。先从你的代码和常见问题点逐一拆解：

1. ArgumentNullException的核心排查方向

你代码里直接调用characteristic.Characteristics[0]，如果GetCharacteristicByServiceUuid返回的characteristic是null，必然会触发这个异常。可能的原因包括：

蓝牙设备未正确连接：UWP中BLE设备连接后，需要确保GATT服务已被成功发现。调用GetCharacteristicByServiceUuid前，一定要确认设备处于已连接状态（可以通过device.ConnectionStatus检查）。
服务/特征UUID错误：小米手环2的步数相关服务/特征UUID可能不是你写的这组——目前逆向出来的资料里，步数服务常用UUID是0000ff0c-0000-1000-8000-00805f9b34fb，对应特征UUID是0000ff08-0000-1000-8000-00805f9b34fb，建议验证替换。
权限缺失：UWP应用必须在Package.appxmanifest中声明蓝牙权限，同时确保系统设置里给了应用蓝牙访问权限：
```
<Capabilities>
  <DeviceCapability Name="bluetooth" />
</Capabilities>
```

2. ProtocolError的常见诱因

如果characteristic不为null，但读取返回ProtocolError，基本是BLE通信层面的限制：

未通过手环认证：小米手环不是开放读取的，必须先完成配对（PIN码通常是0000或1234），再向特定特征发送认证指令获取权限，直接读数据会被设备拒绝，返回ProtocolError。

特征不支持Read操作：小米手环的步数数据一般是通过订阅Notify通知获取，而非主动Read。你可以先检查特征属性确认：

if ((characteristic.Characteristics[0].Properties & GattCharacteristicProperties.Read) != 0)
{
    Debug.WriteLine("该特征支持Read操作");
}
else
{
    Debug.WriteLine("该特征仅支持Notify/Indicate，需订阅通知");
}

蓝牙连接不稳定：UWP的BLE偶尔会因信号差、系统资源不足导致连接异常，读取前务必检查连接状态：

if (device.ConnectionStatus != BluetoothConnectionStatus.Connected)
{
    Debug.WriteLine("设备未连接，需重新连接");
    return;
}

3. 修正后的可行代码思路

结合小米手环2的BLE协议逻辑，正确的步骤应该是：

完成手环配对并确保UWP应用已连接设备
找到正确的步数服务与特征
订阅特征的Notify通知（而非主动Read）来接收步数数据

简化示例代码：

// 假设已获取到连接的蓝牙设备device
var stepService = await device.GetGattServiceAsync(new Guid("0000ff0c-0000-1000-8000-00805f9b34fb"));
if (stepService == null)
{
    Debug.WriteLine("未找到步数服务");
    return;
}

var stepCharResult = await stepService.GetCharacteristicsAsync(new Guid("0000ff08-0000-1000-8000-00805f9b34fb"));
if (stepCharResult.Status != GattCommunicationStatus.Success)
{
    Debug.WriteLine("获取步数特征失败");
    return;
}

var stepCharacteristic = stepCharResult.Characteristics[0];
// 订阅Notify通知
var notifyStatus = await stepCharacteristic.WriteClientCharacteristicConfigurationDescriptorAsync(
    GattClientCharacteristicConfigurationDescriptorValue.Notify);
if (notifyStatus == GattCommunicationStatus.Success)
{
    stepCharacteristic.ValueChanged += StepValueChanged;
    Debug.WriteLine("已订阅步数通知");
}

// 处理步数数据回调
private void StepValueChanged(GattCharacteristic sender, GattValueChangedEventArgs args)
{
    var dataBytes = args.CharacteristicValue.ToArray();
    // 小米手环步数数据为小端序的UInt16，需按协议解析
    var currentSteps = BitConverter.ToUInt16(dataBytes, 0);
    Debug.WriteLine($"当前步数：{currentSteps}");
}