Flutter Reactive BLE UART在Android 8上的连接异常问题（已更新）

错误解析 #

• GATT_CONN_TERMINATE_PEER_USER（状态码19）：外设主动发起断开，通常与配对身份验证失败、连接权限异常直接相关。
• 无法写入CCC描述符（错误码3）：错误码3对应GATT_ERROR，因配对状态异常导致无权限访问可写的Client Characteristic Config描述符，进而触发连接中断。

核心原因 #

1. Android 8 BLE配对机制差异
   Android 8（API 26）的BLE配对密钥存储、身份验证逻辑与后续版本（9+）存在明显区别，对配对后的特征操作权限控制更严格，容易出现密钥不匹配或权限校验失败的情况。

2. 三星S7定制ROM的BLE栈bug
   三星S7的定制Android 8 ROM对BLE协议的实现存在特定兼容性问题，尤其是处理配对后的CCC描述符写入请求时，易触发异常，导致外设主动断开连接。

3. 旧配对记录干扰
   设备配对后，Android 8可能保留了无效或过期的配对密钥，后续连接时身份验证失败，外设因此主动断开（对应状态码19），同时无法完成CCC描述符的写入操作。

为何仅在Android 8出现 #

• 后续Android版本（9+）大幅优化了BLE配对流程、密钥管理机制，修复了这类兼容性问题。
• 三星后续机型的BLE栈经过迭代更新，解决了旧机型上的特定bug。

可行解决方案 #

• 主动清理旧配对记录：在连接外设前，检查并清除该设备的旧配对记录，再重新发起配对连接。
• 延迟CCC描述符写入：确保连接完全稳定、配对流程完成后，再执行CCC描述符的写入操作，避免在连接初期触发权限异常。
• 适配Android 8配对逻辑：针对Android 8设备单独处理配对流程，比如禁用自动配对，改为手动触发配对，或使用低功耗配对模式。

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