安卓蓝牙新设备发现功能实现问题求助

嘿，我来帮你捋捋这个蓝牙设备发现的问题！能访问配对设备但搜不到新设备，大概率是权限配置或者扫描逻辑的坑没踩对，咱们一步步来排查：

一、先把权限配置拉满（最容易翻车的点） #

Android不同版本对蓝牙权限的要求差异很大，先确认你的AndroidManifest.xml里权限加全了：

<!-- 基础蓝牙操作权限 -->
<uses-permission android:name="android.permission.BLUETOOTH" />
<uses-permission android:name="android.permission.BLUETOOTH_ADMIN" />

<!-- 位置权限（Android 6.0+扫描蓝牙必须要） -->
<uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />
<uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION" />

<!-- Android 12+专属扫描/连接权限 -->
<uses-permission 
    android:name="android.permission.BLUETOOTH_SCAN" 
    android:usesPermissionFlags="neverForLocation" />
<uses-permission android:name="android.permission.BLUETOOTH_CONNECT" />

<!-- 声明设备支持蓝牙 -->
<uses-feature android:name="android.hardware.bluetooth" android:required="true" />

光加Manifest权限还不够，必须动态申请权限，比如在启动扫描前做检查：

private static final int REQUEST_BLUETOOTH_PERMS = 1001;

private void checkAndRequestPermissions() {
    List<String> missingPerms = new ArrayList<>();
    
    if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.S) {
        // Android 12+ 检查扫描和连接权限
        if (ContextCompat.checkSelfPermission(this, Manifest.permission.BLUETOOTH_SCAN) != PackageManager.PERMISSION_GRANTED) {
            missingPerms.add(Manifest.permission.BLUETOOTH_SCAN);
        }
        if (ContextCompat.checkSelfPermission(this, Manifest.permission.BLUETOOTH_CONNECT) != PackageManager.PERMISSION_GRANTED) {
            missingPerms.add(Manifest.permission.BLUETOOTH_CONNECT);
        }
    } else {
        // 旧版本检查位置权限
        if (ContextCompat.checkSelfPermission(this, Manifest.permission.ACCESS_FINE_LOCATION) != PackageManager.PERMISSION_GRANTED) {
            missingPerms.add(Manifest.permission.ACCESS_FINE_LOCATION);
        }
    }

    if (!missingPerms.isEmpty()) {
        ActivityCompat.requestPermissions(this, missingPerms.toArray(new String[0]), REQUEST_BLUETOOTH_PERMS);
    } else {
        // 权限全了，开始扫描
        startDiscovery();
    }
}

// 处理权限申请结果
@Override
public void onRequestPermissionsResult(int requestCode, @NonNull String[] permissions, @NonNull int[] grantResults) {
    super.onRequestPermissionsResult(requestCode, permissions, grantResults);
    if (requestCode == REQUEST_BLUETOOTH_PERMS) {
        boolean allGranted = true;
        for (int result : grantResults) {
            if (result != PackageManager.PERMISSION_GRANTED) {
                allGranted = false;
                break;
            }
        }
        if (allGranted) {
            startDiscovery();
        } else {
            Toast.makeText(this, "不给权限的话，我找不到新设备哦😢", Toast.LENGTH_SHORT).show();
        }
    }
}

二、检查扫描逻辑的核心环节 #

从你的代码片段看，已经有BluetoothAdapter实例了，接下来要确保这几点：

1. 蓝牙已经开启：先判断蓝牙状态，没开就引导用户开启

BluetoothAdapter mBluetoothAdapter = BluetoothAdapter.getDefaultAdapter();
if (mBluetoothAdapter == null) {
    // 设备不支持蓝牙
    Toast.makeText(this, "你的设备没有蓝牙功能", Toast.LENGTH_SHORT).show();
    finish();
    return;
}

if (!mBluetoothAdapter.isEnabled()) {
    Intent enableBtIntent = new Intent(BluetoothAdapter.ACTION_REQUEST_ENABLE);
    startActivityForResult(enableBtIntent, REQUEST_ENABLE_BT);
}

2. 注册ACTION_FOUND广播接收器：这是接收扫描到的新设备的关键，别漏了！

private BroadcastReceiver deviceDiscoveryReceiver = new BroadcastReceiver() {
    @Override
    public void onReceive(Context context, Intent intent) {
        String action = intent.getAction();
        if (BluetoothDevice.ACTION_FOUND.equals(action)) {
            // 拿到扫描到的设备
            BluetoothDevice device = intent.getParcelableExtra(BluetoothDevice.EXTRA_DEVICE);
            // 设备名称可能为空，要做判断
            String deviceName = device.getName() != null ? device.getName() : "未知设备";
            String deviceAddr = device.getAddress();
            // 添加到你的设备列表里
            found.add(new connectableDevices(deviceName, deviceAddr));
            // 刷新UI列表
            updateDeviceListUI();
        }
    }
};

// 在onCreate里注册广播
@Override
protected void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);
    setContentView(R.layout.your_activity_layout);
    
    // ...其他初始化代码...
    
    IntentFilter filter = new IntentFilter(BluetoothDevice.ACTION_FOUND);
    registerReceiver(deviceDiscoveryReceiver, filter);
}

// 记得在onDestroy注销广播，防止内存泄漏
@Override
protected void onDestroy() {
    super.onDestroy();
    unregisterReceiver(deviceDiscoveryReceiver);
}

3. 正确启动扫描：扫描是异步操作，别重复调用，先判断是否正在扫描

private void startDiscovery() {
    if (mBluetoothAdapter.isDiscovering()) {
        mBluetoothAdapter.cancelDiscovery();
    }
    mBluetoothAdapter.startDiscovery();
    Toast.makeText(this, "正在扫描附近的蓝牙设备...", Toast.LENGTH_SHORT).show();
}

三、容易忽略的小细节 #

• 目标设备要处于可被发现状态：比如耳机、音箱这类设备，需要长按配对键开启广播模式，不然手机扫不到
• 区分经典蓝牙和BLE：如果你要扫描的是BLE设备，不能用传统的startDiscovery()，得用BluetoothLeScanner来扫描
• 后台扫描限制：Android 10+对后台扫描管得很严，尽量让应用在前台操作扫描，后台大概率扫不到

你可以先按上面的步骤排查权限和广播接收器，这两个是最常见的问题。如果还是不行，把完整的代码贴出来，我再帮你揪问题！

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