Swift iOS：BGProcessingTask后台Core Bluetooth蓝牙连接失败求助

核心问题分析 #

你遇到的问题本质是：BGProcessingTask触发后，临时创建的CBCentralManager被提前释放，或者蓝牙操作不符合iOS后台蓝牙的限制，导致代理回调无法触发。以下是针对性的解决方案和代码修正：

必要的配置检查 #

首先确保你的项目已经正确配置了后台权限：

• 在Capabilities中勾选Background Modes，并启用：
  • Uses Bluetooth LE accessories（对应bluetooth-central后台模式）
  • Background processing（对应processing后台模式）
• 在Info.plist中添加权限描述：
  • NSBluetoothAlwaysUsageDescription：向用户说明蓝牙使用场景（iOS 13+ 必填）
  • NSBluetoothPeripheralUsageDescription：兼容旧版本iOS的蓝牙权限描述
• 确认Info.plist的UIBackgroundModes数组包含bluetooth-central和processing

关键代码修正与实现步骤 #

1. 全局持有CBCentralManager实例 #

不能在handleBackgroundSync中临时创建蓝牙管理器，必须将其作为全局属性持有（比如在AppDelegate中），否则会被ARC提前释放，导致代理回调丢失。

class AppDelegate: UIResponder, UIApplicationDelegate, CBCentralManagerDelegate {
    // 全局持有蓝牙管理器，确保后台任务期间不被释放
    private var centralManager: CBCentralManager!
    // 保存当前的后台任务引用，用于任务完成时标记状态
    private var currentBackgroundTask: BGProcessingTask?

    func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?) -> Bool {
        // 初始化蓝牙管理器，使用后台队列（避免阻塞主队列）
        let bluetoothQueue = DispatchQueue(label: "com.myAppTest.bluetooth", qos: .background)
        centralManager = CBCentralManager(delegate: self, queue: bluetoothQueue, options: [
            CBCentralManagerOptionShowPowerAlertKey: true // 蓝牙关闭时显示系统弹窗
        ])

        // 注册后台任务
        BGTaskScheduler.shared.cancelAllTaskRequests()
        BGTaskScheduler.shared.register(forTaskWithIdentifier: "com.myAppTest.backgroundsync", using: nil) { [weak self] task in
            guard let self = self, let processingTask = task as? BGProcessingTask else {
                task.setTaskCompleted(success: false)
                return
            }
            self.handleBackgroundSync(task: processingTask)
        }
        return true
    }

    // ... 保留你原有的sceneDidEnterBackground、scheduleBackgroundRefresh等方法
}

2. 修改后台任务处理逻辑 #

在handleBackgroundSync中，需要等待蓝牙操作完成后再标记任务结束，同时处理任务超时的情况：

func handleBackgroundSync(task: BGProcessingTask) {
    currentBackgroundTask = task

    // 设置任务过期处理：超时后停止蓝牙操作，标记任务失败
    task.expirationHandler = { [weak self] in
        guard let self = self else { return }
        print("Background task expired")
        self.centralManager.stopScan()
        self.currentBackgroundTask?.setTaskCompleted(success: false)
        self.currentBackgroundTask = nil
    }

    // 检查蓝牙状态，未就绪则直接结束任务
    guard centralManager.state == .poweredOn else {
        print("Bluetooth is not powered on")
        task.setTaskCompleted(success: false)
        currentBackgroundTask = nil
        return
    }

    // 后台扫描必须指定目标服务UUID（iOS限制：后台不能扫描所有设备）
    let targetServiceUUID = CBUUID(string: "YOUR_DEVICE_SERVICE_UUID") // 替换为你的设备服务UUID
    centralManager.scanForPeripherals(withServices: [targetServiceUUID], options: [
        CBCentralManagerScanOptionAllowDuplicatesKey: false
    ])
    print("Started background scan for peripherals")
}

3. 实现CBCentralManager代理方法 #

在代理方法中处理设备发现、连接结果，并在操作完成后标记后台任务状态：

// 发现设备时停止扫描并发起连接
func centralManager(_ central: CBCentralManager, didDiscover peripheral: CBPeripheral, advertisementData: [String : Any], rssi RSSI: NSNumber) {
    print("Discovered peripheral: \(peripheral.name ?? "Unknown")")
    central.stopScan()
    // 发起连接
    central.connect(peripheral, options: nil)
}

// 连接成功后处理后续逻辑，并标记任务完成
func centralManager(_ central: CBCentralManager, didConnect peripheral: CBPeripheral) {
    print("Connected to peripheral: \(peripheral.name ?? "Unknown")")
    // 这里可以添加发现服务、读写特征等操作
    // ...

    // 任务完成，标记成功
    currentBackgroundTask?.setTaskCompleted(success: true)
    currentBackgroundTask = nil
}

// 连接失败时标记任务失败
func centralManager(_ central: CBCentralManager, didFailToConnect peripheral: CBPeripheral, error: Error?) {
    print("Failed to connect: \(error?.localizedDescription ?? "Unknown error")")
    currentBackgroundTask?.setTaskCompleted(success: false)
    currentBackgroundTask = nil
}

// 蓝牙状态更新时的处理（比如用户在任务期间打开蓝牙）
func centralManagerDidUpdateState(_ central: CBCentralManager) {
    guard let task = currentBackgroundTask else { return }
    if central.state == .poweredOn {
        let targetServiceUUID = CBUUID(string: "YOUR_DEVICE_SERVICE_UUID")
        central.scanForPeripherals(withServices: [targetServiceUUID])
    } else {
        print("Bluetooth state changed to: \(central.state.rawValue)")
        task.setTaskCompleted(success: false)
        currentBackgroundTask = nil
    }
}

额外注意事项 #

• 测试技巧：不要等待15分钟触发任务，使用Xcode的Debug > Simulate Background Task直接触发注册的后台任务
• 系统限制：BGProcessingTask的执行时间有限（通常几分钟），蓝牙操作需要尽量高效；系统可能因资源不足暂停蓝牙后台操作
• 设备兼容性：确保目标蓝牙设备处于可连接状态，且广播的服务UUID与你扫描指定的一致

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