Bleak升级后write_gatt_char调用失败的排查求助

问题背景 #

使用Python/Bleak/BleakClient通过自定义UUID和字节串调用write_gatt_char接口，在Bleak 0.19.0版本运行正常，升级至0.21.1版本后报错：

Could not write value b'my_bytes' to characteristic 0014: Protocol Error 0x0E: Unlikely Error

运行环境：Windows 11 Pro（版本10.0.22621 内部版本22621）、Python 3.9.16，因旧版本Windows环境稳定性问题升级。

排查方向 #

• 核对Python版本兼容性
  查看Bleak 0.21.1的版本说明，确认是否对Python 3.9存在兼容隐患；可临时切换至Python 3.10/3.11测试，验证是否为版本适配问题。
• 检查write_gatt_char调用参数
  Bleak 0.19到0.21版本间，write_gatt_char的参数逻辑可能变更，比如新增的response参数（控制是否要求设备响应）。尝试显式指定参数调用：await client.write_gatt_char(uuid, b'my_bytes', response=False)或response=True，匹配设备特征的写入属性。
• 验证BLE设备特征属性
  使用bleak-scan命令重新扫描目标设备，确认特征0014的属性是否支持写入，以及是否允许无响应写入；检查特征属性位的WRITE或WRITE_WITHOUT_RESPONSE标识，确保调用模式与属性匹配。
• 更新Windows BLE驱动与系统
  打开设备管理器，更新蓝牙适配器的厂商最新驱动；安装Windows所有累积更新，修复Win11 BLE组件的兼容性问题。
• 定位版本迭代问题
  尝试降级至Bleak 0.20.x版本测试，判断问题是出在0.20还是0.21的迭代环节，缩小排查范围。
• 启用调试日志
  添加日志代码：import logging; logging.basicConfig(level=logging.DEBUG)，查看详细的BLE交互流程；对比0.19.0与0.21.1版本的日志差异，定位协议错误的触发环节。

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