iOS环境下Flutter蓝牙扫描在IPA安装后失效问题求助

使用flutter_blue_plus开发应用，iPhone 13 mini通过Xcode真机测试时蓝牙扫描正常，但导出IPA安装后（未连接Mac）扫描失效，已确认两次测试的设备权限一致。扫描函数运行在后台模式，Xcode测试时通过Snack Bar可正常查看扫描结果，本人是Flutter和iOS开发新手（入门1个月）。

相关代码参考 #

蓝牙扫描函数 #

Future<void> initialScanning() async {
  // ios execute this function with .ipa installed but skips scanning.
  final FlutterBluePlus flutterBlue = FlutterBluePlus.instance;
  // Start scanning
  flutterBlue.startScan(timeout: Duration(seconds: _firstScanDuration));
  // Listen to scan results
  var subscription = flutterBlue.scanResults.listen((results) async {
    // Find the device with the name and Register
    for (ScanResult r in results) {
      print('${r.device.name} rssi: ${r.rssi}');
      if (r.device.name == 'raspberrypi') {
        if (!devices.contains(r.device)) {
          devices.add(r.device);
          print('device added!!!!');
        }
      }
    }
    for (BluetoothDevice device in devices) {
      if (!registeredDevices.contains(device.id.toString())) {
        registeredDevices.add(device.id.toString());
        await someBleRegister(device);
      }
    }
  });
  // Stop scanning
  flutterBlue.stopScan();
}

flutter_foreground_task的onEvent函数 #

@override
Future<void> onEvent(DateTime timestamp, SendPort? sendPort) async {
  if (_eventCount == 0) {
    await initialScanning();
  } else {
    print('number of devices: ${someBles.length}');
    for (SomeBle ble in someRegisteredBles) {
      await someBleReadAndWrite(ble);
    }
  }
}

排查与解决建议 #

• 修复扫描时序问题：当前代码调用startScan后立刻执行stopScan，扫描还未启动就被终止。Xcode调试时因日志、断点延迟让扫描有执行时间，但IPA包运行时速度更快，直接跳过扫描。修改逻辑等待扫描超时完成后再停止：

  Future<void> initialScanning() async {
    final FlutterBluePlus flutterBlue = FlutterBluePlus.instance;
    var subscription = flutterBlue.scanResults.listen((results) async {
      // 原处理逻辑不变
    });
    // 等待扫描超时结束
    await Future.delayed(Duration(seconds: _firstScanDuration));
    // 停止扫描并取消订阅
    await flutterBlue.stopScan();
    subscription.cancel();
  }
  

• 确认iOS蓝牙权限配置：检查Info.plist是否添加完整的蓝牙权限描述：
  • NSBluetoothAlwaysUsageDescription：后台蓝牙使用的权限说明文本
  • NSBluetoothPeripheralUsageDescription：兼容iOS 12及以下版本的蓝牙权限
    同时在Xcode的「Signing & Capabilities」中开启Background Modes下的Uses Bluetooth LE accessories选项。
• 验证前台服务后台稳定性：检查flutter_foreground_task的初始化配置，确保后台任务触发逻辑正常，比如是否配置了正确的通知权限、服务类型是否包含蓝牙相关标识，保证扫描函数能在后台被正确调用。
• 添加日志排查：IPA包无法通过Xcode查看日志，可集成本地日志库（如logger）将日志写入文件，或用Firebase Crashlytics收集运行日志，确认initialScanning是否执行、scanResults是否有回调、是否有权限或异常抛出。
• 前置蓝牙状态检查：扫描前先确认设备蓝牙是否开启，避免因蓝牙未激活导致扫描失败：

  // 在initialScanning开头添加
  BluetoothState state = await flutterBlue.state.first;
  if (state != BluetoothState.on) {
    // 提示用户开启蓝牙或等待蓝牙激活
    return;
  }
  

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