Kotlin调用startDiscovery扫描蓝牙启停正常但无设备找到问题排查

问题核心原因 #

你的问题本质是Android 6.0（API 23）及以上版本的权限适配缺失，具体原因如下：

• ACCESS_COARSE_LOCATION/ACCESS_FINE_LOCATION属于危险权限，仅在AndroidManifest.xml中静态声明无效，必须在运行时主动向用户申请授权，未获得授权时系统会直接屏蔽ACTION_FOUND广播，因此你只能收到扫描启停的事件，收不到设备发现的回调。
• 你的测试设备是运行Android 6.1的Nexus 7，刚好适配该规则，系统设置页能搜到设备是因为系统应用本身已经有位置权限，普通第三方应用必须主动申请。

修复步骤 #

1. 新增运行时权限申请逻辑 #

在启动蓝牙扫描前先检查权限，未授权时先发起权限申请，参考代码如下：
首先在Activity中定义权限请求常量：

private val REQUEST_BLUETOOTH_PERMISSIONS = 1001
private val requiredPermissions = if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.S) {
    arrayOf(
        android.Manifest.permission.BLUETOOTH_SCAN,
        android.Manifest.permission.BLUETOOTH_CONNECT,
        android.Manifest.permission.ACCESS_FINE_LOCATION
    )
} else {
    arrayOf(
        android.Manifest.permission.ACCESS_FINE_LOCATION
    )
}

在你当前启动扫描的逻辑前，先加权限检查：

// 检查是否已经获得所需权限
val allGranted = requiredPermissions.all {
    ContextCompat.checkSelfPermission(this, it) == PackageManager.PERMISSION_GRANTED
}
if (allGranted) {
    // 已有权限，直接启动扫描
    startBluetoothDiscovery()
} else {
    // 没有权限，发起申请
    ActivityCompat.requestPermissions(
        this,
        requiredPermissions,
        REQUEST_BLUETOOTH_PERMISSIONS
    )
}

把你原来注册广播、启动扫描的逻辑封装成startBluetoothDiscovery()方法即可。
再重写权限申请结果回调：

override fun onRequestPermissionsResult(
    requestCode: Int,
    permissions: Array<out String>,
    grantResults: IntArray
) {
    super.onRequestPermissionsResult(requestCode, permissions, grantResults)
    if (requestCode == REQUEST_BLUETOOTH_PERMISSIONS) {
        val allGranted = grantResults.all { it == PackageManager.PERMISSION_GRANTED }
        if (allGranted) {
            startBluetoothDiscovery()
        } else {
            binding.textView1.text = "缺少必要权限，无法扫描蓝牙设备"
        }
    }
}

2. 开启设备位置开关 #

Android 6.0+蓝牙扫描要求设备的位置（GPS）开关处于开启状态，你需要先手动打开测试平板的位置功能，再启动应用测试。

3. 补充可选优化 #

• 你的广播接收器目前是onCreate里的局部变量，建议提升为类成员变量，在onDestroy()中调用unregisterReceiver(receiver)注销，避免内存泄漏。
• 如果后续需要兼容Android 12及以上版本，可以在Manifest的BLUETOOTH_SCAN权限声明中添加android:usesPermissionFlags="neverForLocation"属性（如果你的应用不需要通过蓝牙获取设备物理位置），可以避免申请位置权限。

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