Kotlin应用无法连接ESP32S蓝牙Socket问题排查求助

算力阿峰

2026-6-20

问题代码

val device: BluetoothDevice = bluetoothAdapter.getRemoteDevice(deviceAddress)
val uuid: UUID = UUID.fromString(uuidString)
try {
    bluetoothSocket = device.createRfcommSocketToServiceRecord(uuid)
    Log.d("BluetoothHelper", "Socket created: $bluetoothSocket")
    bluetoothSocket.connect()
    Log.d("BluetoothHelper", "Socket connected: $bluetoothSocket")
    inputStream = bluetoothSocket.inputStream
} catch (e: Exception) {
    e.printStackTrace()
    Log.d("BluetoothHelper", "Socket failed!!!!!!!!!!!! $bluetoothSocket")
}

问题描述

我正尝试通过BLE蓝牙将Kotlin应用连接至ESP32S设备，但connect()函数始终无法生效。日志仅打印“Socket created”与“Socket failed”，无“Socket connected”记录。调试发现bluetoothSocket已正确关联设备（deviceAddress和UUID均为硬编码），OutputStream已赋值，但连接未建立，inputStream始终为null。我已尝试反转UUID（因CPP代码用字节数组、Kotlin用字符串），但无改善。当前其他蓝牙功能正常，请问还有哪些可能的故障原因？connect()未接收额外参数，为何会连接失败？

故障排查与解决建议

核心误区：混淆经典蓝牙与BLE
你用的createRfcommSocketToServiceRecord()是经典蓝牙（BR/EDR）SPP协议的API，而BLE是完全独立的蓝牙技术栈，ESP32如果配置成BLE模式，根本不会监听RFCOMM端口。先确认ESP32端的蓝牙类型：
- 若用BLE，需改用Android BLE专属API（BluetoothGatt相关方法），而非经典蓝牙的Socket连接；
- 若用经典蓝牙SPP，继续排查以下点。
ESP32端经典蓝牙配置验证
检查ESP32代码：
- 是否正确初始化SPP服务（比如Arduino环境用BluetoothSerial库，调用SerialBT.begin("ESP32")）；
- 服务UUID是否与Kotlin端完全一致，ESP32的SPP默认UUID是00001101-0000-1000-8000-00805F9B34FB，自定义UUID需确保两端格式匹配；
- 有没有代码阻塞蓝牙连接线程，导致服务无法响应连接请求。
Android权限问题
Android 12及以上版本，经典蓝牙连接需要BLUETOOTH_CONNECT权限，且必须动态申请（不能仅在Manifest声明）。旧版本Android可能还需要ACCESS_FINE_LOCATION权限才能扫描和连接设备，确认权限申请流程是否完整。
设备配对状态
经典蓝牙连接前必须完成配对：
- 若ESP32设置了配对码，手机端需先输入配对码完成配对，否则connect()直接失败；
- 若已配对但连接失败，可尝试删除系统蓝牙设置里的配对记录，重新配对后再试。
UUID格式正确性
若ESP32用的是16位UUID（比如0x1101），Kotlin端必须补全为标准128位UUID格式（00001101-0000-1000-8000-00805F9B34FB），不能直接传入16位字符串。另外注意UUID的大小写、分隔符必须完全一致，反转UUID仅适用于字节序不匹配的场景，若ESP32无特殊字节序处理，无需反转。
设备可达性与硬件问题
- 确认ESP32处于手机蓝牙有效范围内，信号过弱会导致连接超时；
- 检查ESP32的蓝牙模块供电是否充足，天线是否正常连接，硬件故障也会引发连接失败。

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