BLE GattCharacteristic写入失败：finalGatt空指针异常排查求助

咱们一步步拆解你遇到的这个finalGatt空指针问题，先揪出核心原因，再给你修复方案，最后聊聊更稳定的BLE长连接实现方式。

一、空指针的核心原因排查 #

从你描述的情况（连接日志正常但调用sendMessage时finalGatt为null）来看，大概率是Gatt实例的引用管理或生命周期出了问题，这是BLE开发里的高频坑：

1. Gatt实例的保存时机完全错误 #

你在onConnectionStateChange回调里收到STATE_CONNECTED状态时，是不是先打印了"dev connected.."日志，再给finalGatt赋值？甚至根本没做赋值操作？
比如错误写法：

@Override
public void onConnectionStateChange(BluetoothGatt gatt, int status, int newState) {
    if (newState == BluetoothGatt.STATE_CONNECTED) {
        Log.d(TAG, "dev connected..");
        // 赋值在日志之后，若sendMessage在日志打印后立刻调用，就会拿到null
        finalGatt = gatt;
    }
}

如果sendMessage的调用时机比赋值早，或者你完全漏掉了赋值步骤，finalGatt必然是null。

2. 跨类调用时引用传递失效 #

你提到是跨类调用sendMessage，要检查这几点：

• 持有finalGatt的类是不是单例？如果是多实例，调用方拿到的可能是未初始化的实例，finalGatt自然为空。
• 是不是在BLE连接成功前就把类实例传给了调用方？后续连接成功后也没更新调用方手里的引用，导致调用时还是拿的空实例。

3. Gatt实例被意外回收/生命周期不匹配 #

如果finalGatt是定义在Activity/Fragment里的，当页面销毁（比如屏幕旋转、后台被系统回收），原有实例会被销毁，新实例的finalGatt是null，但你可能还在调用旧实例的sendMessage方法。另外，如果finalGatt用了弱引用，也可能被GC回收导致空指针。

4. 异步竞态条件 #

BLE所有操作都是异步的，哪怕你看到了连接成功的日志，也不代表Gatt已经完成了服务发现，但如果你的sendMessage不需要服务发现直接写特征值，核心问题还是Gatt实例没被正确赋值。

二、快速修复步骤 #

1. 修正赋值时机：在onConnectionStateChange里，收到STATE_CONNECTED时，先赋值finalGatt，再做其他操作：

@Override
public void onConnectionStateChange(BluetoothGatt gatt, int status, int newState) {
    if (newState == BluetoothGatt.STATE_CONNECTED) {
        // 先赋值，再打印日志、做服务发现
        finalGatt = gatt;
        Log.d(TAG, "dev connected..");
        finalGatt.discoverServices();
    } else if (newState == BluetoothGatt.STATE_DISCONNECTED) {
        // 断开时必须清空引用+关闭Gatt，避免内存泄漏
        if (finalGatt != null) {
            finalGatt.close();
            finalGatt = null;
        }
    }
}

2. 修复跨类引用问题：
   • 如果用单例管理BLE连接，确保单例里的finalGatt是全局唯一的，连接成功后及时更新。
   • 如果用接口回调传递，确保调用方拿到的是连接成功后初始化完成的实例。
3. 避免在页面类里持有Gatt：Activity/Fragment的生命周期太不稳定，建议用前台服务来管理BLE连接，彻底避开页面销毁导致的引用丢失问题。

三、更可靠的BLE长连接实现方案（每秒写入特征值） #

要保持持续连接并定时写入数据，前台服务是最优解，推荐架构如下：

1. 用前台Service管理BLE连接 #

把所有BLE操作（连接、服务发现、写特征值）都放在Service里，Service持有BluetoothGatt实例，不受页面生命周期影响；同时把Service设为前台服务，避免被系统后台回收，还能显示通知告知用户连接状态。

2. 用Handler实现定时写入（避免阻塞线程） #

不能用Thread.sleep()来做定时，会阻塞线程，推荐用Handler.postDelayed()循环调用：

private Handler writeHandler = new Handler(Looper.getMainLooper());
private Runnable writeRunnable = new Runnable() {
    @Override
    public void run() {
        // 先做非空判断，避免空指针
        if (finalGatt != null && targetCharacteristic != null) {
            byte[] writeData = getYourWriteData(); // 替换成你的待写入数据
            targetCharacteristic.setValue(writeData);
            finalGatt.writeCharacteristic(targetCharacteristic);
        }
        // 1秒后再次执行
        writeHandler.postDelayed(this, 1000);
    }
};

// 连接成功后启动定时任务
public void startPeriodicWrite() {
    writeHandler.post(writeRunnable);
}

// 断开连接/服务销毁时停止任务
public void stopPeriodicWrite() {
    writeHandler.removeCallbacks(writeRunnable);
}

3. 处理写入回调，保证可靠性 #

每次写入后会触发onCharacteristicWrite回调，要在这里处理写入结果，比如写入失败时重试，避免后续定时任务无效：

@Override
public void onCharacteristicWrite(BluetoothGatt gatt, BluetoothGattCharacteristic characteristic, int status) {
    super.onCharacteristicWrite(gatt, characteristic, status);
    if (status != BluetoothGatt.GATT_SUCCESS) {
        // 写入失败，可根据业务逻辑重试
        Log.e(TAG, "Write failed, status: " + status);
    }
}

4. 内存泄漏防护 #

• 断开连接时必须调用BluetoothGatt.close()，并清空finalGatt和特征值的引用。
• Service销毁时，一定要停止定时任务，关闭Gatt连接。

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