Flutter_bluetooth_serial无法与HC-05建立连接问题求助

核心问题分析 #

点击连接按钮后无反应，说明连接流程未正常触发或执行过程中出现静默错误，结合你的代码和场景，从以下几个方向排查：

1. 权限缺失（最常见原因） #

Android和iOS都需要明确的蓝牙权限才能建立连接，检查你的配置文件：

• Android（AndroidManifest.xml）：

  <!-- 基础蓝牙权限（Android 11及以下） -->
  <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_FINE_LOCATION" />
  

• iOS（Info.plist）：

  <key>NSBluetoothAlwaysUsageDescription</key>
  <string>需要蓝牙权限连接IoT设备</string>
  <key>NSBluetoothPeripheralUsageDescription</key>
  <string>需要蓝牙权限连接IoT设备</string>
  

2. 设备未配对或配对异常 #

HC-05需要先与手机完成配对才能建立串口连接：

• 进入手机蓝牙设置，手动配对HC-05（默认密码通常为1234或0000）
• 在设备列表页添加配对状态判断，确保传入ChatPage的BluetoothDevice是已配对设备

3. 连接逻辑无用户反馈 #

你的代码中连接失败仅打印日志，用户无法感知错误，修改catchError部分添加UI提示：

.catchError((error) {
  print('Cannot connect, exception occured');
  print(error);
  // 给用户显示连接失败原因
  if (mounted) {
    ScaffoldMessenger.of(context).showSnackBar(
      SnackBar(content: Text('连接失败：${error.toString()}')),
    );
    setState(() {
      isConnecting = false;
    });
  }
});

4. 代码潜在问题修复 #

• Dispose方法空安全错误：原代码中connection = null!会触发空安全异常，修改为：

  @override
  void dispose() {
    if (isConnected) {
      isDisconnecting = true;
      connection!.dispose();
      connection = null; // 移除强制解包符号!
    }
    super.dispose();
  }
  

• 指定HC-05波特率：如果你的HC-05波特率不是默认9600，连接时需明确指定（部分版本支持）：

  BluetoothConnection.toAddress(widget.server.address, timeout: Duration(seconds: 5))
  // 部分版本支持直接指定波特率
  // BluetoothConnection.toAddress(widget.server.address, baudRate: 9600)
  

5. 连接触发逻辑确认 #

如果ChatPage是点击连接按钮后跳转的页面，确保跳转时正确传递BluetoothDevice对象：

// 设备列表页的连接按钮逻辑示例
ElevatedButton(
  onPressed: () {
    Navigator.push(
      context,
      MaterialPageRoute(
        builder: (context) => ChatPage(server: selectedDevice),
      ),
    );
  },
  child: Text('连接'),
);

修改后的关键代码片段 #

@override
void initState() {
  super.initState();

  BluetoothConnection.toAddress(widget.server.address)
      .then((_connection) {
    print('Connected to the device');
    connection = _connection;
    setState(() {
      isConnecting = false;
      isDisconnecting = false;
    });

    connection!.input.listen(_onDataReceived).onDone(() {
      String disconnectMsg = isDisconnecting ? '本地断开连接' : '远程设备断开连接';
      if (mounted) {
        ScaffoldMessenger.of(context).showSnackBar(
          SnackBar(content: Text(disconnectMsg)),
        );
        setState(() {});
      }
    });
  }).catchError((error) {
    print('Cannot connect, exception occured');
    print(error);
    if (mounted) {
      ScaffoldMessenger.of(context).showSnackBar(
        SnackBar(content: Text('连接失败：${error.toString()}')),
      );
      setState(() {
        isConnecting = false;
      });
    }
  });
}

@override
void dispose() {
  if (isConnected) {
    isDisconnecting = true;
    connection!.dispose();
    connection = null;
  }
  super.dispose();
}

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