Android蓝牙客户端Socket连接异常：read failed问题求助

嘿，我太懂这个报错的头疼了——这绝对是Android蓝牙开发里排得上号的“经典坑”！你已经查了不少帖子但还没解决，咱们一步步来揪出问题根源，把这个报错彻底干掉：

先排查最容易踩的坑：权限配置 #

别小看权限，Android 12+的蓝牙权限规则改了不少，少一个都可能导致连接失败：

• 首先在AndroidManifest.xml里添加必要权限：

<!-- Android 11及以下 -->
<uses-permission android:name="android.permission.BLUETOOTH" />
<uses-permission android:name="android.permission.BLUETOOTH_ADMIN" />
<uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />

<!-- Android 12+ 新增权限 -->
<uses-permission android:name="android.permission.BLUETOOTH_CONNECT" />
<uses-permission android:name="android.permission.BLUETOOTH_SCAN" android:usesPermissionFlags="neverForLocation" />

<!-- 声明蓝牙功能 -->
<uses-feature android:name="android.hardware.bluetooth" android:required="true" />

• 还要在代码里动态申请危险权限（比如BLUETOOTH_CONNECT、ACCESS_FINE_LOCATION），尤其是Android 6.0+，不动态申请的话权限会被系统拒绝。

必须确保UUID完全匹配 #

这是90%的人会踩的坑！客户端和服务器端必须使用完全相同的UUID，不能随便用默认值或者不同的UUID。
推荐用蓝牙SPP服务的标准UUID（大部分蓝牙设备都支持）：

private val MY_UUID = UUID.fromString("00001101-0000-1000-8000-00805F9B34FB")

如果是你自己开发的蓝牙服务器，一定要保证两边的UUID一模一样，差一个字符都不行！

修正你的ConnectThread实现 #

你的ConnectThread可能存在线程处理不当、超时设置缺失或者资源泄漏的问题，给你一个经过验证的正确实现：

class MainActivity : AppCompatActivity() {
    private val bluetoothAdapter = BluetoothAdapter.getDefaultAdapter()
    private var connectThread: ConnectThread? = null
    private val MY_UUID = UUID.fromString("00001101-0000-1000-8000-00805F9B34FB")

    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        setContentView(R.layout.activity_main)
        // 这里可以添加触发连接的逻辑，比如点击按钮
    }

    // 连接蓝牙设备的方法
    fun connectToDevice(device: BluetoothDevice) {
        // 先取消之前的连接
        connectThread?.cancel()
        // 启动新的连接线程
        connectThread = ConnectThread(device, MY_UUID)
        connectThread?.start()
    }

    inner class ConnectThread(private val device: BluetoothDevice, private val uuid: UUID) : Thread() {
        private val mmSocket: BluetoothSocket? by lazy(LazyThreadSafetyMode.NONE) {
            device.createRfcommSocketToServiceRecord(uuid)
        }

        override fun run() {
            // 先取消蓝牙扫描，避免占用资源
            bluetoothAdapter?.cancelDiscovery()

            mmSocket?.use { socket ->
                try {
                    // 设置5秒连接超时，避免无限等待
                    socket.connect(BluetoothDevice.createRfcommSocketToServiceRecord(uuid), 5000)
                    // 连接成功后，启动读取数据的线程
                    manageConnectedSocket(socket)
                } catch (e: IOException) {
                    Log.e("BluetoothError", "连接失败: ${e.message}")
                    // 连接失败要关闭socket
                    socket.close()
                }
            }
        }

        // 关闭连接
        fun cancel() {
            try {
                mmSocket?.close()
            } catch (e: IOException) {
                Log.e("BluetoothError", "关闭socket失败: ${e.message}")
            }
        }

        private fun manageConnectedSocket(socket: BluetoothSocket) {
            // 这里要在单独的子线程读取输入流，不能阻塞主线程
            Thread {
                val inputStream = socket.inputStream
                val buffer = ByteArray(1024)
                var bytes: Int
                try {
                    while (inputStream.read(buffer).also { bytes = it } != -1) {
                        // 处理读取到的数据，比如发送到主线程更新UI
                        val receivedMessage = String(buffer, 0, bytes)
                        runOnUiThread {
                            // 这里添加更新UI的逻辑，比如显示收到的消息
                        }
                    }
                } catch (e: IOException) {
                    Log.e("BluetoothError", "读取数据失败: ${e.message}")
                    socket.close()
                }
            }.start()
        }
    }

    override fun onDestroy() {
        super.onDestroy()
        // 页面销毁时关闭连接
        connectThread?.cancel()
    }
}

注意几个关键点：

• 连接前一定要调用cancelDiscovery()，扫描会占用蓝牙资源，导致连接失败
• 设置连接超时时间（比如5秒），避免无限等待
• 读取输入流必须在单独的子线程，不能阻塞连接线程
• 异常捕获后一定要关闭socket，避免资源泄漏
• 页面销毁时要主动关闭连接，避免内存泄漏

其他排查要点 #

• 确保设备已配对：如果目标蓝牙设备还没和你的手机配对，先在系统设置里完成配对，再尝试连接
• 使用最新的BluetoothDevice实例：不要用缓存的设备对象，最好通过蓝牙扫描获取最新的设备实例，旧的实例可能已经失效
• Android版本适配：Android 10+如果需要后台连接蓝牙，还需要申请ACCESS_BACKGROUND_LOCATION权限，但前台连接一般不需要
• 测试兼容性：有些蓝牙设备的兼容性不好，尽量用主流品牌的设备测试，或者检查设备的蓝牙协议是否支持SPP

最后，把这些点逐一排查，尤其是UUID和权限，大概率能解决这个报错！

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