CoreBluetooth后台扫描异常：BGAppRefreshTask无法正常工作

核心问题分析 #

你的前台扫描正常但后台失效，主要是以下几个关键错误导致：

1. 后台模式配置错误：启用了Background Fetch而非BLE专属的后台模式
2. 扫描参数不符合iOS后台限制：后台扫描不允许withServices: nil
3. 核心实例未初始化：AppDelegate中central变量未创建实例
4. 错误依赖BGAppRefreshTask：CoreBluetooth本身支持后台扫描，无需依赖后台刷新任务触发

步骤1：修正后台模式配置 #

• 在Xcode的Signing & Capabilities中添加Background Modes，勾选Uses Bluetooth LE Accessories
• 对应info.plist需包含：

  <key>UIBackgroundModes</key>
  <array>
      <string>bluetooth-central</string>
  </array>
  

• 确保info.plist添加蓝牙权限描述：NSBluetoothAlwaysUsageDescription（iOS13+）

步骤2：修正BLECentral代码 #

后台扫描必须指定目标服务UUID，不能传nil，以下是调整后的代码：

import Foundation
import CoreBluetooth

class BLECentral: NSObject, CBCentralManagerDelegate {
    
    var manager: CBCentralManager!
    var discoveredPeripherals = [DiscoveredPeripheral]()
    var onDiscovered: (()->Void)?
    
    // 替换为你的BLE设备实际广播的服务UUID
    let targetServiceUUID = CBUUID(string: "0000FFE0-0000-1000-8000-00805F9B34FB")
    
    override init() {
        super.init()
        // 使用后台队列避免阻塞主线程
        manager = CBCentralManager(delegate: self, queue: DispatchQueue.global(qos: .background))
    }
    
    func scanForPeripherals() {
        let options: [String: Any] = [
            CBCentralManagerScanOptionAllowDuplicatesKey: false
        ]
        // 后台扫描必须指定service UUID
        manager.scanForPeripherals(withServices: [targetServiceUUID], options: options)
        print("启动BLE扫描")
    }
    
    // MARK: - CBCentralManagerDelegate
    func centralManagerDidUpdateState(_ central: CBCentralManager) {
        switch central.state {
        case .poweredOn:
            scanForPeripherals()
        case .poweredOff:
            print("蓝牙已关闭")
        case .unauthorized:
            print("蓝牙权限未授权")
        default:
            print("Central不可用: \(central.state.rawValue)")
        }
    }
    
    func centralManager(_ central: CBCentralManager, didDiscover peripheral: CBPeripheral, advertisementData: [String : Any], rssi RSSI: NSNumber) {
        // 用设备唯一ID判断重复，而非对象引用
        if let existingIndex = discoveredPeripherals.firstIndex(where: {$0.peripheral.identifier == peripheral.identifier}) {
            discoveredPeripherals[existingIndex].advertisementData = advertisementData
            discoveredPeripherals[existingIndex].rssi = RSSI
        } else {
            discoveredPeripherals.append(DiscoveredPeripheral(peripheral: peripheral, rssi: RSSI, advertisementData: advertisementData))
        }
        
        print("发现设备: \(peripheral.name ?? "未知")，广播数据: \(advertisementData)")
        onDiscovered?()
    }
}

步骤3：修正AppDelegate代码 #

核心是初始化BLECentral实例，并正确处理后台任务（可选）：

import UIKit
import CoreBluetooth
import BackgroundTasks

@main
class AppDelegate: UIResponder, UIApplicationDelegate {

    var central: BLECentral!
    var window: UIWindow?
    var flowController: AppFlowController?

    func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?) -> Bool {
        
        window = UIWindow(frame: UIScreen.main.bounds)
        flowController = AppFlowController(window: window!)
        flowController?.start()
        
        // 关键：初始化BLECentral实例（之前遗漏）
        central = BLECentral()
        
        // 可选：后台任务辅助扫描（非必须，CoreBluetooth本身支持后台扫描）
        BGTaskScheduler.shared.register(forTaskWithIdentifier: "com.blebacktrial.refresh", using: nil) { (task) in
            self.handleAppRefresh(task: task as! BGAppRefreshTask)
        }
        scheduleAppRefresh()
        
        return true
    }

    func handleAppRefresh(task: BGAppRefreshTask) {
        if central.manager.state == .poweredOn {
            central.scanForPeripherals()
        }
        // 必须标记任务完成，否则系统会终止APP
        task.setTaskCompleted(success: true)
        scheduleAppRefresh()
    }
    
    func scheduleAppRefresh() {
        let request = BGAppRefreshTaskRequest(identifier: "com.blebacktrial.refresh")
        request.earliestBeginDate = Date(timeIntervalSinceNow: 60)
        
        do {
            try BGTaskScheduler.shared.submit(request)
            print("后台任务已调度")
        } catch {
            print("调度失败: \(error)")
        }
    }
    
    // MARK: UISceneSession Lifecycle
    func application(_ application: UIApplication, configurationForConnecting connectingSceneSession: UISceneSession, options: UIScene.ConnectionOptions) -> UISceneConfiguration {
        return UISceneConfiguration(name: "Default Configuration", sessionRole: connectingSceneSession.role)
    }

    func application(_ application: UIApplication, didDiscardSceneSessions sceneSessions: Set<UISceneSession>) {
    }
}

额外注意事项 #

• 如果无法修改BLE设备的广播UUID，可以改用iBeacon协议，通过CoreLocation的后台监测iBeacon实现设备识别
• iOS后台扫描频率会被系统限制（省电策略），无法达到前台实时性
• 测试后台扫描时，必须将APP切换到后台（不能用Xcode调试时暂停），可以通过Xcode控制台查看日志

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