uniapp 在真机 uni.onbluetoothdevicefound 不生效是什么原因

在uniapp开发中，使用uni.onbluetoothdevicefound监听蓝牙设备时，真机调试不生效，但模拟器正常。已确认已调用uni.openBluetoothAdapter初始化蓝牙模块，并检查了权限配置无误。真机型号为XXX，系统版本XX，其他蓝牙API如startBluetoothDevicesDiscovery可正常调用。请问可能是什么原因导致的？如何排查或解决？

nodeper 1楼

可能原因：

未正确调用 uni.openBluetoothAdapter
设备已连接或已配对
系统权限未开启
设备不支持BLE
搜索超时或信号弱

建议检查权限和初始化流程，确保在搜索状态监听设备。

yibo5220 2楼作者

在 UniApp 中，uni.onBluetoothDeviceFound 在真机上不生效通常由以下原因导致。请按步骤排查：

1. 未正确初始化蓝牙适配器

必须先调用 uni.openBluetoothAdapter 成功初始化后才能监听设备发现事件。

uni.openBluetoothAdapter({
  success: (res) => {
    console.log('蓝牙适配器初始化成功');
    // 开始监听设备
    uni.onBluetoothDeviceFound((devices) => {
      console.log('发现设备:', devices);
    });
  },
  fail: (err) => {
    console.error('初始化失败:', err);
  }
});

2. 未开始搜索设备

初始化后需调用 uni.startBluetoothDevicesDiscovery 启动搜索：

uni.startBluetoothDevicesDiscovery({
  services: [], // 可指定服务UUID，非必填
  success: (res) => {
    console.log('开始搜索设备');
  },
  fail: (err) => {
    console.error('搜索失败:', err);
  }
});

3. 系统权限问题

Android：确保应用已获取 ACCESS_FINE_LOCATION 权限（Android 6.0+ 需要动态申请）。
iOS：需在 manifest.json 中配置蓝牙权限，且系统版本需支持。

4. 设备兼容性或系统限制

部分安卓机型可能需开启定位服务（GPS）。
iOS 设备需在系统设置中开启蓝牙并授权应用。

5. 监听时机错误

确保 onBluetoothDeviceFound 在初始化成功后立即调用，避免延迟或遗漏。

6. 回调频率限制

设备发现回调可能因系统节流而间隔触发，建议在回调中累积设备列表。

完整示例代码：

export default {
  methods: {
    initBluetooth() {
      uni.openBluetoothAdapter({
        success: () => {
          this.startDiscovery();
          uni.onBluetoothDeviceFound((res) => {
            console.log('发现设备:', res.devices);
          });
        },
        fail: (err) => {
          uni.showToast({ title: '蓝牙初始化失败', icon: 'none' });
        }
      });
    },
    startDiscovery() {
      uni.startBluetoothDevicesDiscovery({
        services: [],
        success: () => console.log('搜索中...'),
        fail: (err) => console.error('启动搜索失败:', err)
      });
    }
  },
  onLoad() {
    this.initBluetooth();
  }
}