Flutter iOS端调用BluetoothThermalPrinter.getBluetooths类型转换错误

问题分析 #

你遇到的type 'String' is not a subtype of type 'List<dynamic>?' in type cast错误，本质是BluetoothThermalPrinter.getBluetooths在iOS端返回了字符串（大概率是错误信息）而非预期的设备列表数组；[CoreBluetooth] XPC connection invalid则和蓝牙权限、系统蓝牙服务连接异常有关。

具体解决方案 #

1. 安全处理Dart端返回值 #

不要直接强转成List，先判断返回类型，避免类型转换崩溃：

Future<void> getBluetooth() async {
  await Permission.bluetooth.request();
  await Permission.bluetoothScan.request();
  await Permission.bluetoothConnect.request();

  try {
    final result = await BluetoothThermalPrinter.getBluetooths;
    // 先判断返回类型，避免强制转换报错
    if (result is List) {
      availableBluetoothDevices = result;
      print("扫描到蓝牙设备: $availableBluetoothDevices");
    } else {
      // 打印异常返回值，排查具体错误原因
      print("蓝牙扫描返回异常内容: $result");
      availableBluetoothDevices = [];
    }
    update();
  } catch (e) {
    print("扫描蓝牙出错: $e");
  }
}

2. 补充iOS蓝牙权限描述 #

iOS 14+需要单独的扫描和连接权限描述，在info.plist中补充以下配置：

<key>NSBluetoothScanUsageDescription</key>
<string>需要蓝牙扫描权限来查找打印机</string>
<key>NSBluetoothConnectUsageDescription</key>
<string>需要蓝牙连接权限来连接打印机</string>

保留你已有的NSBluetoothAlwaysUsageDescription和NSBluetoothPeripheralUsageDescription，确保权限请求覆盖所有iOS版本。

3. 修复CoreBluetooth XPC连接问题 #

• 彻底清理iOS构建缓存：删除项目根目录的ios/Pods文件夹、ios/Podfile.lock，然后执行cd ios && pod install
• 重启Xcode和Flutter项目，确保权限配置生效
• 测试前关闭设备蓝牙再重新开启，排除系统蓝牙服务异常

4. 排查插件兼容性 #

• 确认BluetoothThermalPrinter插件版本是否为最新，升级到最新版本尝试修复已知iOS端bug
• 查看插件的社区反馈，是否有其他用户遇到相同的iOS扫描问题，参考已有的解决方案

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