Android 11中BluetoothAdapter.startDiscovery()返回false的排查方法

问题背景 #

开发的蓝牙设备发现与连接应用在Android 10、12智能手机上运行正常，但在搭载Android 11的Teclast M40 Pro平板上调用BluetoothAdapter.startDiscovery()始终返回false，已完成以下排查：

• 清单文件配置了完整的蓝牙、位置权限（尝试过带/不带maxSdkVersion="28"的ACCESS_COARSE_LOCATION）
• 运行时已确认所有必要权限均授予
• 蓝牙状态已确认开启，三台设备均关闭GPS但仅Android 11平板出现问题

一、获取startDiscovery失败的详细错误信息 #

startDiscovery()仅返回布尔值，无直接错误码，但可通过以下方式抓取系统层面的日志信息：

1. 过滤蓝牙系统日志
   在Logcat中添加过滤器，筛选BluetoothManagerService或BluetoothAdapter标签的日志，或直接搜索startDiscovery关键字，系统服务层会输出更具体的失败原因（如权限校验失败、蓝牙服务异常、硬件限制等）。
2. 检查蓝牙服务状态
   通过adb命令查看蓝牙服务运行状态：

   adb shell dumpsys bluetooth_manager
   

   或检查蓝牙进程是否存活：

   adb shell ps | grep bluetooth
   

二、针对Android 11的专项排查点 #

1. 修正权限配置 #

Android 11（API 30）下，ACCESS_COARSE_LOCATION的maxSdkVersion="28"配置错误——API 29-30仍需该权限进行蓝牙扫描，建议调整权限配置：

<!-- 适配Android 11的权限配置 -->
<!-- Before Android 12 -->
<uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION" />
<uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" android:maxSdkVersion="30" />
<uses-permission android:name="android.permission.ACCESS_BACKGROUND_LOCATION" android:maxSdkVersion="30"/>
<uses-permission android:name="android.permission.BLUETOOTH" android:maxSdkVersion="30" />
<uses-permission android:name="android.permission.BLUETOOTH_ADMIN" android:maxSdkVersion="30" />
<!-- From Android 12 -->
<uses-permission android:name="android.permission.BLUETOOTH_SCAN" android:usesPermissionFlags="neverForLocation" />
<uses-permission android:name="android.permission.BLUETOOTH_CONNECT" />

同时检查平板隐私设置中，是否单独禁用了应用的位置权限（部分定制系统会有额外的权限开关）。

2. 检查蓝牙扫描模式 #

Android 11中蓝牙适配器的扫描模式可能被系统限制，调用mBluetoothAdapter.getScanMode()确认模式：

• 若返回SCAN_MODE_NONE，则无法执行扫描，需请求开启可发现模式：

if (mBluetoothAdapter.getScanMode() != BluetoothAdapter.SCAN_MODE_CONNECTABLE_DISCOVERABLE
        && mBluetoothAdapter.getScanMode() != BluetoothAdapter.SCAN_MODE_CONNECTABLE) {
    Intent discoverableIntent = new Intent(BluetoothAdapter.ACTION_REQUEST_DISCOVERABLE);
    discoverableIntent.putExtra(BluetoothAdapter.EXTRA_DISCOVERABLE_DURATION, 300);
    startActivity(discoverableIntent);
}

3. 排查系统定制或硬件问题 #

Teclast平板的定制Android系统可能对蓝牙扫描有额外限制：

• 重启平板后重试，排除临时服务异常
• 检查系统设置中是否有蓝牙相关的特殊选项（如"蓝牙扫描权限独立开关"、"位置与蓝牙关联设置"）
• 测试系统自带蓝牙功能是否能正常发现设备，若系统功能也异常，可能是硬件故障或系统固件bug

4. 尝试使用BluetoothLeScanner替代（BLE设备适用） #

如果目标设备是BLE蓝牙设备，可尝试使用Android 5.0+推荐的BluetoothLeScanner进行扫描，避开传统扫描的限制：

BluetoothLeScanner scanner = mBluetoothAdapter.getBluetoothLeScanner();
ScanCallback scanCallback = new ScanCallback() {
    @Override
    public void onScanResult(int callbackType, ScanResult result) {
        super.onScanResult(callbackType, result);
        // 处理扫描到的BLE设备
    }
};
// 启动扫描
scanner.startScan(scanCallback);

Android 11及以下仍需位置权限，Android 12+需BLUETOOTH_SCAN权限。

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