本文详解Web Bluetooth API中无法发送消息的典型问题，重点指出遗漏startNotifications()调用导致写入阻塞，并提供可运行的修复代码、关键注意事项与调试建议。
本文详解web bluetooth api中无法发送消息的典型问题，重点指出遗漏startnotifications()调用导致写入阻塞，并提供可运行的修复代码、关键注意事项与调试建议。
在使用 Web Bluetooth API 向 BLE 设备（如运行 Python 的接收端）发送数据时，若调用 characteristic.writeValue() 后既无成功日志也无错误抛出——即“卡在中间”——最常见且隐蔽的原因是：未正确获取目标特征值（Characteristic），或遗漏了对通知/指示（Notifications/Indications）的启用步骤，尤其当该特征值需先订阅才能接受写入时。
你提供的代码中存在多个关键缺陷，我们逐项修复：
✅ 1. 正确获取指定服务与特征值
原代码中：
const service = await server.getPrimaryServices(); // 返回 Service 数组！ const characteristic = await service.getCharacteristic(); // ❌ 错误：service 是数组，且未指定 UUID
getPrimaryServices() 返回的是 Service[]，必须先筛选出目标服务（例如通过 UUID），再调用其 getCharacteristic()。同时，0x2A00 是 Generic Access Service 中的 Device Name 特征值 UUID，但仅声明在 optionalServices 中并不保证能访问——需显式指定并匹配设备实际暴露的 UUID。
✅ 修复后：
// 假设你的设备在 0x1800 (Generic Access) 服务下暴露 0x2A00 (Device Name) 特征值
const service = await server.getPrimaryService('00001800-0000-1000-8000-00805f9b34fb');
const characteristic = await service.getCharacteristic('00002a00-0000-1000-8000-00805f9b34fb');? 提示：使用标准 UUID 格式（如
'00002a00-...'）而非短格式0x2A00，否则getCharacteristic()将失败且静默拒绝。
✅ 2. 必须调用 startNotifications()（关键！）
正如答案所指出：若该特征值要求“启用通知”后才允许写入（常见于某些固件设计或 Python BLE 库如 bleak 的默认行为），则必须先调用 characteristic.startNotifications()。否则 writeValue() 可能被挂起、无响应、甚至被设备忽略。
✅ 完整流程应为：
// ✅ 启用通知（即使你只写不读，部分设备/栈也强制要求） await characteristic.startNotifications(); // ✅ 然后写入（注意：writeValue 要求 characteristic 具有 'write' 属性） await characteristic.writeValue(data);
⚠️ 注意：startNotifications() 本身会触发 characteristic.addEventListener('characteristicvaluechanged', ...)，你可借此确认通道已就绪。
✅ 3. 完整可运行修复版代码
const sendStringToDevice = async () => {
try {
const device = await navigator.bluetooth.requestDevice({
filters: [{ name: 'monocle' }], // 或使用 services: ['00001800-...']
optionalServices: ['00001800-0000-1000-8000-00805f9b34fb']
});
const server = await device.gatt.connect();
// 显式获取服务与特征值（使用完整 UUID）
const service = await server.getPrimaryService('00001800-0000-1000-8000-00805f9b34fb');
const characteristic = await service.getCharacteristic('00002a00-0000-1000-8000-00805f9b34fb');
// ? 关键：启用通知（解决“卡住”问题）
await characteristic.startNotifications();
// 编码并写入
const encoder = new TextEncoder('utf-8');
const data = encoder.encode(message);
await characteristic.writeValue(data);
console.log(`String "${message}" sent successfully to monocle`);
} catch (error) {
console.error('Error sending string to Bluetooth device:', error);
}
};⚠️ 重要注意事项
-
权限与上下文：Web Bluetooth 仅在安全上下文（HTTPS 或
localhost）中可用，且需用户主动触发（如按钮点击）。 -
Python 端兼容性：确保 Python 服务（如
bleak）将目标特征值配置为支持WRITE_WITHOUT_RESPONSE或WRITE，并正确处理on_write回调；若特征值仅支持NOTIFY，则写入前必须先订阅。 -
调试技巧：在
startNotifications()后添加监听器验证：characteristic.addEventListener('characteristicvaluechanged', event => { console.log('Notification received:', new TextDecoder().decode(event.target.value)); });
遵循以上修正，即可彻底解决“消息发送无响应”的悬停问题，实现从浏览器到 Python 设备的稳定通信。
