本文详解如何避免 NullPointerException，通过优化 RecyclerView Adapter 设计与事件回调机制，安全地将扫描到的蓝牙设备从 ScanActivity 传递至业务逻辑层，并支持后续连接操作。重点涵盖适配器单例初始化、线程安全更新、点击事件解耦及设备去重处理。

本文详解如何避免 `nullpointerexception`，通过优化 recyclerview adapter 设计与事件回调机制，安全地将扫描到的蓝牙设备从 `scanactivity` 传递至业务逻辑层，并支持后续连接操作。重点涵盖适配器单例初始化、线程安全更新、点击事件解耦及设备去重处理。

在 Android 蓝牙开发中，一个常见却极易引发崩溃的问题是：在 BroadcastReceiver 中频繁创建新 RecyclerView.Adapter 实例，并试图直接访问未初始化或已被回收的 BluetoothDevice 对象——这正是原始代码中 NullPointerException 的根本原因。问题核心不在于“如何传设备”，而在于“如何以线程安全、生命周期一致、职责清晰的方式组织数据流”。

✅ 正确的数据流向设计原则

1. Adapter 单次初始化，多次复用
   ❌ 错误：每次发现设备都新建 Bluetooth_adapter(data, context) 并调用 setAdapter()
   ✅ 正确：onCreate() 中仅初始化一次 BluetoothScanListAdapter，并通过 addDevice() 方法动态更新数据集。

2. UI 更新必须在主线程执行
   BroadcastReceiver.onReceive() 运行在 Binder 线程，不可直接操作 RecyclerView 或 View。应使用 Handler.post() 或 runOnUiThread() 切换至主线程：

   

   Mapbox Android Patterns

   Mapbox Maps SDK 在 Android 上的官方集成模式，涵盖安装、添加标记、用户定位、自定义数据、样式、相机控制等功能

   下载

   handler.post(() -> scanListAdapter.addDevice(new BluetoothDeviceModel(name, address, logoRes)));

3. 点击事件解耦：使用接口回调替代构造函数传参
   不要尝试在 ViewHolder 中持有 BluetoothDevice 引用（易因列表复用失效），而是通过定义 DeviceSelectListener 接口，在点击时将完整的 BluetoothDeviceModel 安全回传：

   public interface DeviceSelectListener {
       void onDeviceSelected(BluetoothDeviceModel deviceModel);
   }

? 关键代码重构实践

Step 1：重构 ScanActivity —— 初始化监听器与 Adapter

// onCreate() 中一次性设置
final DeviceSelectListener deviceSelectListener = new DeviceSelectListener() {
    @Override
    public void onDeviceSelected(BluetoothDeviceModel deviceModel) {
        // ✅ 安全获取已选设备信息
        String address = deviceModel.getAddress();
        String name = deviceModel.getName();

        // ? 启动连接 Activity（示例）
        Intent intent = new Intent(ScanActivity.this, ConnectActivity.class);
        intent.putExtra("device_address", address);
        intent.putExtra("device_name", name);
        startActivity(intent);

        // 或直接调用连接逻辑（需适配 Android 12+ 权限）
        // connectToDevice(address);
    }
};
scanListAdapter = new BluetoothScanListAdapter(deviceSelectListener);
recyclerViewSD.setAdapter(scanListAdapter);

Step 2：重构 BluetoothScanListAdapter —— 支持动态添加与安全点击

public class BluetoothScanListAdapter extends RecyclerView.Adapter<BluetoothViewHolder> {
    private final List<BluetoothDeviceModel> devices = new ArrayList<>();
    private final DeviceSelectListener selectListener;

    public BluetoothScanListAdapter(DeviceSelectListener selectListener) {
        this.selectListener = selectListener;
    }

    // ✅ 线程安全添加设备（自动去重）
    public void addDevice(BluetoothDeviceModel device) {
        if (devices.stream().noneMatch(d -> d.getAddress().equals(device.getAddress()))) {
            devices.add(device);
            notifyItemInserted(devices.size() - 1); // 局部刷新，性能更优
        }
    }

    @Override
    public void onBindViewHolder(@NonNull BluetoothViewHolder holder, int position) {
        BluetoothDeviceModel model = devices.get(position);
        holder.deviceNamePD.setText(model.getName() != null ? model.getName() : model.getAddress());
        holder.dropdownImgPD.setImageResource(model.getImageresouce());

        holder.cardViewPD.setOnClickListener(v -> {
            int pos = holder.getAbsoluteAdapterPosition(); // ✅ 使用绝对位置防复用错位
            if (pos >= 0 && pos < devices.size()) {
                BluetoothDeviceModel selected = devices.get(pos);
                if (selected != null && selectListener != null) {
                    selectListener.onDeviceSelected(selected); // ? 安全回调
                }
            }
        });
    }

    @Override
    public int getItemCount() {
        return devices.size();
    }
}

⚠️ 必须注意的陷阱与最佳实践

• 权限适配（Android 12+）：BLUETOOTH_SCAN、BLUETOOTH_CONNECT、ACCESS_FINE_LOCATION 需动态申请，且 onReceive() 中不可直接调用 requestPermissions()（非 Activity 上下文）。应在 onCreate() 或用户触发扫描前统一申请。
• 广播接收器生命周期：务必在 onResume() 注册、onPause() 及时注销，避免内存泄漏；cancelDiscovery() 应在 onPause() 和 reload() 中调用。
• 设备地址唯一性：使用 device.getAddress() 做去重判断（而非名称），因名称可能为空或重复。
• 连接前校验：传递 address 至目标 Activity 后，需再次通过 BluetoothAdapter.getRemoteDevice(address) 获取 BluetoothDevice 实例，并检查是否支持 fetchUuidsWithSdp() 或 createBond()。
• 避免 handler.postDelayed() 误用：原始代码中每次发现设备都触发 4s 延迟隐藏进度条，会导致多次执行。应改为扫描结束统一处理（如监听 BluetoothAdapter.ACTION_DISCOVERY_FINISHED）。

✅ 总结：构建健壮蓝牙设备交互链路

环节	关键动作	目的
扫描发现	startDiscovery() + ACTION_FOUND 广播	获取设备元数据
UI 同步	Handler.post() → adapter.addDevice()	线程安全更新列表
用户选择	ViewHolder 点击 → getAbsoluteAdapterPosition() → 回调	避免复用导致的 NullPointerException
跨组件传递	Intent.putExtra() 传递 address/name	解耦 UI 与连接逻辑
后续连接	在目标 Activity 中 getRemoteDevice() + 权限校验 + createBond()	安全建立配对

通过以上重构，你将获得一个可维护、无崩溃风险、符合 Android 架构规范的蓝牙设备扫描与连接流程。记住：设备不是“传过去”的对象，而是“被引用并安全操作”的资源——设计的核心永远是生命周期感知与线程边界控制。