flutter_bluetooth_serial/flutter_blue后台蓝牙扫描报“Bluetooth is not available”问题求助

错误根源 #

1. 权限适配缺失：Android 12+和iOS对后台蓝牙访问的权限规则大幅收紧，flutter_bluetooth_serial、flutter_blue这类较旧的包未适配新系统的后台权限要求——比如Android需要明确声明ACCESS_BACKGROUND_LOCATION和前台服务类型，iOS需要开启蓝牙后台模式。
2. 进程隔离导致蓝牙服务绑定失败：flutter_background_service默认可能创建独立后台进程，而旧蓝牙包的底层实现未做跨进程蓝牙服务绑定处理，导致后台进程无法获取蓝牙适配器实例，返回“不可用”。
3. 后台蓝牙初始化逻辑缺陷：旧包在后台环境下未主动触发蓝牙适配器绑定流程，依赖前台初始化状态，一旦进程切换就丢失蓝牙连接实例。

可行解决方案 #

1. 补全系统权限配置（核心步骤） #

Android端

修改android/app/src/main/AndroidManifest.xml：

<!-- 兼容旧系统蓝牙权限 -->
<uses-permission android:name="android.permission.BLUETOOTH" android:maxSdkVersion="30" />
<uses-permission android:name="android.permission.BLUETOOTH_ADMIN" android:maxSdkVersion="30" />

<!-- Android 12+ 必需权限 -->
<uses-permission android:name="android.permission.BLUETOOTH_SCAN" />
<uses-permission android:name="android.permission.BLUETOOTH_CONNECT" />

<!-- 后台扫描必需的位置权限 -->
<uses-permission android:name="android.permission.ACCESS_BACKGROUND_LOCATION" />

<!-- 声明后台服务的前台类型 -->
<service
    android:name="com.your.package.YourBackgroundService"
    android:foregroundServiceType="location|bluetooth" />

注意：必须在前台引导用户授予BLUETOOTH_SCAN、BLUETOOTH_CONNECT和ACCESS_BACKGROUND_LOCATION权限，后台无法弹出权限请求。

iOS端

修改Info.plist：

<key>NSBluetoothAlwaysUsageDescription</key>
<string>需要蓝牙权限进行设备扫描与通讯</string>
<key>UIBackgroundModes</key>
<array>
    <string>bluetooth-central</string>
</array>

2. 让后台服务与主进程同进程运行 #

修改flutter_background_service的初始化配置，避免进程隔离：

• 在AndroidManifest.xml中，给后台服务移除android:process=":background"属性（如果有）。
• Dart端初始化服务时，确保启用前台模式：

await FlutterBackgroundService().configure(
  iosConfiguration: IosConfiguration(
    autoStart: true,
    onForeground: onStart,
    onBackground: onIosBackground,
  ),
  androidConfiguration: AndroidConfiguration(
    onStart: onStart,
    autoStart: true,
    isForegroundMode: true, // 必须开启前台模式，否则后台蓝牙会被系统限制
    notificationChannelId: "your_background_channel",
    initialNotificationTitle: "蓝牙扫描中",
    initialNotificationContent: "正在后台扫描蓝牙设备",
  ),
);

3. 后台主动初始化蓝牙适配器（针对flutter_bluetooth_serial） #

在后台服务启动时，强制触发蓝牙适配器绑定流程，不依赖前台状态：

Future<void> initBluetoothInBackground() async {
  // 先检查蓝牙是否开启
  bool isEnabled = await FlutterBluetoothSerial.instance.isEnabled;
  if (!isEnabled) {
    // 后台无法弹出开启请求，需提前让用户在前台开启蓝牙
    return;
  }
  // 强制获取适配器状态，触发绑定
  BluetoothAdapterState state = await FlutterBluetoothSerial.instance.state;
  if (state != BluetoothAdapterState.STATE_ON) {
    // 极端情况尝试重启适配器
    await FlutterBluetoothSerial.instance.restartAdapter();
  }
}

4. 前台服务保活与权限校验 #

在后台扫描启动前，用permission_handler包校验所有必需权限：

import 'package:permission_handler/permission_handler.dart';

Future<bool> checkBluetoothPermissions() async {
  final scanPerm = await Permission.bluetoothScan.request();
  final connectPerm = await Permission.bluetoothConnect.request();
  final bgLocPerm = await Permission.locationAlways.request();
  
  return scanPerm.isGranted && connectPerm.isGranted && bgLocPerm.isGranted;
}

只有权限全部通过，再启动后台扫描逻辑。

排查技巧 #

1. 日志追踪：在后台服务的蓝牙初始化步骤中添加详细日志，比如打印FlutterBluetoothSerial.instance.state的变化及权限检查结果，通过adb logcat查看后台进程的日志输出。
2. 进程验证：用adb shell ps | grep com.your.package命令，确认后台服务和主进程是否为同一PID，排除进程隔离问题。
3. 分步测试：先验证前台蓝牙扫描正常，再测试应用退到后台（按Home键）的扫描状态，最后测试应用完全退出后的后台扫描，逐步缩小问题范围。
4. 对比测试：临时用flutter_blue_plus的后台扫描逻辑作为参照，排查是否是权限或进程配置问题，而非代码逻辑错误。

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