Android Studio开发的Zebra TC26 App经蓝牙向ZD420发ZPL指令时无法连接设备

问题背景 #

当前基于Android Studio开发的App已集成Zebra官方SDK，运行时尝试遍历所有已配对蓝牙设备连接ZD420发送ZPL指令，抛出连接异常：

W/System.err: com.zebra.sdk.comm.ConnectionException: Could not connect to device: read failed, socket might closed or timeout, read ret: -1
W/System.err:     at com.zebra.sdk.comm.ConnectionA.throwAsConnectionException(Unknown Source:42)

现有实现代码如下：

val bAdapter: BluetoothAdapter = BluetoothAdapter.getDefaultAdapter()
for (device in bAdapter.bondedDevices) {
    sendZplOverBluetooth(device.address.toString())
}

private fun sendZplOverBluetooth(theBtMacAddress: String) {
    try {
        val thePrinterConn: Connection = BluetoothConnection(theBtMacAddress)
        thePrinterConn.open()
        if (thePrinterConn.isConnected) {
            val zplData = "^XA^FO20,20^A0N,25,25^FDThis is a ZPL test.^FS^XZ"
            thePrinterConn.write(zplData.toByteArray())
            thePrinterConn.close()
        }
    } catch (e: java.lang.Exception) {
        e.printStackTrace()
    }
}

该报错本质是安卓端蓝牙RFCOMM数据通道建立失败，可按以下顺序排查：

排查步骤 #

1. 校验安卓系统权限适配 #

Zebra SDK的蓝牙连接逻辑完全依赖安卓系统的蓝牙权限，TC26通常搭载安卓11及以上版本系统，权限规则较旧版本有明显变化：

• 按系统版本匹配Manifest静态权限：
  • 安卓11及以下：需声明BLUETOOTH、BLUETOOTH_ADMIN、ACCESS_FINE_LOCATION权限
  • 安卓12及以上：需新增声明BLUETOOTH_SCAN、BLUETOOTH_CONNECT两个危险权限
• 必须做动态权限申请：上述蓝牙权限在安卓12及以上属于运行时危险权限，仅在Manifest静态声明不会被系统授予，若未动态申请，SDK发起蓝牙连接时会被系统静默拦截，直接触发socket超时、通道关闭的报错。

2. 修正设备遍历连接逻辑 #

当前代码会循环对所有已配对蓝牙设备发起连接，是最容易触发报错的逻辑问题：

• 禁止盲连所有已配对设备：遍历设备列表时，先通过设备名称、MAC地址筛选出匹配ZD420的目标设备，再发起连接。若列表中混有耳机、扫描枪等其他蓝牙外设，连接非目标设备时必然触发通道读取失败的报错。
• 提前完成手动配对流程：先在TC26的系统蓝牙设置页手动将ZD420配对成功，不要在App运行时临时触发配对流程，避免系统配对弹窗阻塞连接流程。
• 检查蓝牙设备占用状态：确认ZD420没有被其他手机、电脑或外设建立蓝牙连接，打印机被占用时会拒绝所有新的RFCOMM连接请求。

3. 适配Zebra SDK的蓝牙通道参数 #

默认的BluetoothConnection初始化逻辑在新安卓系统上存在兼容性问题：

• 固定SPP服务UUID：安卓12以上系统对动态RFCOMM端口查找做了限制，SDK默认动态查找通道的逻辑容易超时失败，初始化连接时需指定固定的经典蓝牙SPP UUID00001101-0000-1000-8000-00805F9B34FB，修改后的初始化示例：

// 指定SPP端口和固定UUID的连接初始化方式
val thePrinterConn: Connection = BluetoothConnection(
    theBtMacAddress, 
    1, 
    "00001101-0000-1000-8000-00805F9B34FB"
)

• 补充连接超时配置：在打开连接前调用thePrinterConn.setConnectionTimeout(5000)将连接超时设置为5秒，避免蓝牙通道协商较慢时被系统判定为连接失败。
• 避免重复发起连接：不要在设备遍历循环中连续调用open()方法，需等上一个连接完全释放后，再发起下一次连接请求，防止Socket被占用触发"socket might closed"的报错。

4. 校验打印机本身配置 #

• 确认ZD420已开启经典蓝牙SPP服务：ZD420默认可能启用BLE蓝牙模式，而Zebra SDK的BluetoothConnection仅支持经典蓝牙SPP协议，不支持BLE连接，需在打印机配置中开启SPP模式。
• 重启打印机后确认蓝牙广播状态：打印机重启后若未自动初始化蓝牙服务，就算已配对过也无法建立连接。

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