使用Bluetooth 5.0适配器时蓝牙连接超时失败问题咨询

1. 修复逻辑执行顺序错误 #

现有代码存在致命逻辑问题：搜索到匹配的已认证蓝牙设备后直接调用return true，导致后续创建套接字、发起连接的代码完全不会执行，先调整此处逻辑，同时补充蓝牙5要求的主动配对逻辑：

do {
  if (wcscmp(btDeviceInfo.szName, wcDeviceName) == 0) {
    printf("A Device found");
    if (btDeviceInfo.fAuthenticated)
    {
      printf("Bluetooth Device authenticated");
      *addr = btDeviceInfo.Address.ullLong;
      break; // 替换原return true，跳出搜索循环执行后续连接逻辑
    } else {
      printf("Bluetooth device not authenticated");
      // 蓝牙5默认禁止未认证设备建立RFCOMM连接，新增主动配对逻辑
      DWORD authRet = BluetoothAuthenticateDeviceEx(NULL, NULL, &btDeviceInfo, NULL, 0);
      if (authRet == ERROR_SUCCESS) {
        *addr = btDeviceInfo.Address.ullLong;
        break;
      }
    }
  }
} while (BluetoothFindNextDevice(btDevice, &btDeviceInfo));
// 新增设备存在校验
if (*addr == NULL) {
  printf("No matched authenticated bluetooth device found");
  return false;
}

2. 适配蓝牙5的设备搜索参数 #

蓝牙5适配器默认同时扫描BLE和传统蓝牙设备，未明确扫描类型时可能获取到BLE设备地址，RFCOMM协议无法连接BLE地址，修改搜索参数如下：

constexpr BLUETOOTH_DEVICE_SEARCH_PARAMS btDeviceSearchParameters = {
    sizeof(BLUETOOTH_DEVICE_SEARCH_PARAMS),
    1, // fIssueInquiry 发起主动查询
    0, // fReturnAuthenticated
    1, // fReturnRemembered
    1, // fReturnUnknown
    1, // fReturnConnected
    5, // ulTimeout 从2秒调整为5秒，适配蓝牙5更长的扫描周期
    nullptr, // hRadio
    1, // fSearchForClassicDevices 仅搜索传统BR/EDR蓝牙设备
    0 // fSearchForLEDevices 过滤BLE设备，如连接BLE设备需改用GATT API
};

如果你的目标设备是BLE蓝牙设备，不能使用RFCOMM协议连接，需要切换为Winsock BLE相关API

3. 修正连接配置参数 #

蓝牙5驱动对参数校验更严格，原有SOCKADDR_BTH的参数配置错误是超时的核心原因，修正后代码如下：

btClientSocket_ = socket(AF_BTH, SOCK_STREAM, BTHPROTO_RFCOMM);
if (btClientSocket_ == INVALID_SOCKET) {
  printf("Create bluetooth socket failed, error: %d", WSAGetLastError());
  return false;
}

SOCKADDR_BTH btSocketAddress{};
btSocketAddress.addressFamily = AF_BTH;
// 原参数错误：不能填RFCOMM_PROTOCOL_UUID，需替换为目标设备的服务UUID，以下为标准SPP服务UUID示例
GUID sppServiceUuid = { 0x00001101, 0x0000, 0x1000, { 0x80, 0x00, 0x00, 0x80, 0x5F, 0x9B, 0x34, 0xFB } };
btSocketAddress.serviceClassId = sppServiceUuid;
btSocketAddress.port = 0; // 配合正确的服务UUID可自动匹配端口
btSocketAddress.btAddr = *addr; // 修复原代码指针赋值错误，需取addr指向的地址值

if (connect(btClientSocket_, reinterpret_cast<SOCKADDR*>(&btSocketAddress), sizeof btSocketAddress) != 0)
{
  printf("Failed to connect to bluetooth device, error: %d", WSAGetLastError());
  closesocket(btClientSocket_);
  return false;
}

4. 其他必要适配项 #

• 确保蓝牙5适配器的驱动已更新到官方最新版本，部分旧版公版驱动对Winsock2蓝牙API兼容性较差
• Win10/11系统下需在项目manifest中声明蓝牙权限：

  <Capabilities>
      <DeviceCapability Name="bluetooth" />
  </Capabilities>
  

• 调用所有Winsock API前必须先初始化Winsock库，要求版本不低于2.2：

  WSADATA wsaData;
  if (WSAStartup(MAKEWORD(2,2), &wsaData) != 0) {
    return false;
  }
  

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