CoreBluetooth中didConnect回调始终未触发的BLE连接问题求助

API 探路者

2026-4-8

我最近在给iOS app写BLE连接和信令代码，对接的是自己做的自定义设备，结果碰到个特别棘手的问题：设备明明能被正常发现，但就是连不上——didConnect和didFailToConnect这两个中央管理器的回调完全没反应，可离谱的是didDisconnectPeripheral函数却工作得一点毛病都没有。有没有大佬能帮我分析分析该怎么解决呀？

我目前的代码大概是这样的（之前import语句打错了，已经修正）：

import CoreBluetooth

class BLEManager: NSObject, CBCentralManagerDelegate, CBPeripheralDelegate {
    var centralManager: CBCentralManager!
    var targetPeripheral: CBPeripheral?

    override init() {
        super.init()
        // 初始化中央管理器并绑定代理
        centralManager = CBCentralManager(delegate: self, queue: nil)
    }

    // 发现设备的回调，这里能正常识别到目标设备
    func centralManager(_ central: CBCentralManager, didDiscover peripheral: CBPeripheral, advertisementData: [String : Any], rssi RSSI: NSNumber) {
        if peripheral.name == "我的自定义设备" {
            targetPeripheral = peripheral
            print("尝试连接设备: \(peripheral.name ?? "未知设备")")
            // 发起连接请求，但之后完全没触发成功/失败回调
            centralManager.connect(peripheral, options: nil)
        }
    }

    // 这个连接成功回调完全没触发
    func centralManager(_ central: CBCentralManager, didConnect peripheral: CBPeripheral) {
        print("设备连接成功")
        peripheral.delegate = self
        peripheral.discoverServices(nil)
    }

    // 这个连接失败回调也没触发
    func centralManager(_ central: CBCentralManager, didFailToConnect peripheral: CBPeripheral, error: Error?) {
        print("连接失败，错误信息: \(error?.localizedDescription ?? "未知错误")")
    }

    // 唯独这个断开连接回调正常工作
    func centralManager(_ central: CBCentralManager, didDisconnectPeripheral peripheral: CBPeripheral, error: Error?) {
        print("设备已断开连接")
    }
}

我自己也梳理了几个可能的排查方向，大家也可以帮我看看有没有遗漏：

先确认中央管理器的状态：调用connect的时候，必须保证CBCentralManager的状态是.poweredOn，如果是设备蓝牙未开启、app未获得蓝牙权限这些异常状态，连接请求会被直接忽略，自然不会触发任何回调。最好在centralManagerDidUpdateState回调里先做状态校验，只有状态正常了再发起连接。
检查连接请求的执行时机：会不会是在发现设备后太急着调用connect了？有时候设备的广播包还没完全解析，或者app的队列被阻塞，可能导致连接请求没被系统正确处理。可以试试延迟个几百毫秒再调用连接，或者明确指定在主线程里执行这个操作。
排查自定义设备的固件问题：毕竟是自己做的设备，会不会BLE栈的连接响应逻辑有bug？比如设备收到了iOS的连接请求，但没给出回复，那iOS端就一直等不到回调。可以用LightBlue这类工具测试连接设备，看能不能正常连上，先排除设备端的问题。
确认代理的强引用：会不会是我的BLEManager实例被提前释放了？比如如果它是个局部变量，ARC回收之后，代理对象没了，自然收不到回调。得确保这个管理器实例是全局的，或者有其他强引用持有它。
检查蓝牙权限配置：iOS 13及以上版本需要在Info.plist里配置NSBluetoothAlwaysUsageDescription（旧版本是NSBluetoothPeripheralUsageDescription），如果没配的话，系统可能会静默拒绝蓝牙操作，导致连接失败但没任何提示。

内容来源于stack exchange