Android BLE扫描onScanFailed错误（SCAN_FAILED_ALREADY_STARTED）求助

我之前在项目中碰到过几乎一模一样的BLE扫描问题，结合你的代码场景和描述，来帮你梳理问题根源和可行的解决方案：

问题复盘 #

你当前的核心问题是：在使用Fragment的Activity中，每次显示第一个Fragment时通过onResume()启动BLE扫描，切换4-5次Fragment后，Android 7.0+设备会触发ScanCallback.onScanFailed()，错误码为SCAN_FAILED_ALREADY_STARTED（错误码1）。尝试重启扫描也无法彻底解决，且偶尔失败后仍能扫到信标，问题表现不稳定。

问题根源分析 #

1. 扫描未被正确停止：切换Fragment时，第一个Fragment的onPause()/onStop()方法大概率没有调用停止扫描的逻辑，导致旧的扫描进程未被终止，新的扫描请求触发时，系统检测到相同配置的扫描已在运行，抛出错误。
2. Android 7.0+的扫描限制：从Android 7.0开始，系统对BLE扫描的并发次数、重复启动相同配置扫描的行为有了更严格的管控，重复触发相同扫描请求会直接触发该错误。
3. ScanCallback实例复用问题：如果每次启动扫描都创建新的ScanCallback实例，旧的回调可能未被系统正确解绑，导致系统认为扫描仍在运行。

可行解决方案 #

1. 确保Fragment不可见时停止扫描 #

在第一个Fragment的onPause()方法中主动停止扫描，避免切换Fragment时残留扫描进程：

@Override
public void onPause() {
    super.onPause();
    // 切换Fragment时停止扫描
    scanLeDevice(false, getContext());
}

这样每次Fragment隐藏时都会终止扫描，再次显示（onResume()）时启动新的扫描，从根源上避免重复扫描冲突。

2. 增加扫描状态校验，避免重复调用 #

在Fragment中维护一个扫描状态标记，调用scanLeDevice()前先校验状态，相同状态直接返回：

private boolean isScanning = false;

protected void scanLeDevice(final boolean enable, Context applicationContext) {
    // 状态相同则直接返回，避免重复操作
    if (enable == isScanning) {
        return;
    }
    isScanning = enable;

    // 原有的扫描逻辑代码...
}

即使onResume()被多次触发（比如Fragment重建），也不会重复发起扫描请求。

3. 复用ScanCallback实例，避免重复创建 #

不要每次启动扫描都新建ScanCallback，建议在Fragment初始化时只创建一次回调实例：

private ScanCallback mScanCallback;

@Override
public void onCreate(@Nullable Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);
    // 只初始化一次ScanCallback
    mScanCallback = new ScanCallback() {
        @Override
        public void onScanResult(int callbackType, ScanResult result) {
            // 处理扫描结果逻辑
        }

        @Override
        public void onBatchScanResults(List<ScanResult> results) {
            // 处理批量扫描结果逻辑
        }

        @Override
        public void onScanFailed(int errorCode) {
            super.onScanFailed(errorCode);
            if (errorCode == ScanCallback.SCAN_FAILED_ALREADY_STARTED) {
                // 先强制停止现有扫描，再延迟重启
                scanLeDevice(false, getContext());
                new Handler(Looper.getMainLooper()).postDelayed(() -> {
                    scanLeDevice(true, getContext());
                }, 500);
            }
        }
    };
}

复用同一个回调实例，系统能更准确地识别扫描的启动/停止状态，减少冲突概率。

4. 优化扫描模式与权限检查 #

• Android 7.0+要求必须拥有ACCESS_FINE_LOCATION权限才能扫描BLE设备，确保你已经在Manifest中声明权限，并且完成了运行时授权。
• 如果你不需要实时高频率扫描，可以将ScanSettings.SCAN_MODE_LOW_LATENCY替换为SCAN_MODE_BALANCED，降低系统资源占用，也能减少触发扫描限制的概率。

额外排查点 #

• 检查是否有其他组件（比如Activity、其他Fragment）也在启动BLE扫描，导致跨组件的扫描冲突。
• 查看日志确认每次停止扫描的调用是否成功，有没有异常抛出导致停止逻辑执行失败。

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