React Native 集成 HMS Geofencing 仅触发首次事件无后续更新问题求助

问题排查与修复方案 #

1. 围栏请求转换类型配置错误（最高概率原因） #

你当前配置的conversionType仅包含初始化触发类参数，未配置正常的进入、退出围栏触发类型，所以只有创建围栏时会触发一次回调，后续位置变更不会触发事件。
修复代码：

const conversionType =
  // 初始化触发类型（可选，按业务需求保留）
  HMSLocation.Geofence.Native.GeofenceRequestConstants.ENTER_INIT_CONVERSION |
  HMSLocation.Geofence.Native.GeofenceRequestConstants.EXIT_INIT_CONVERSION |
  // 新增正常进入、退出围栏触发类型
  HMSLocation.Geofence.Native.GeofenceRequestConstants.ENTER_GEOFENCE_CONVERSION |
  HMSLocation.Geofence.Native.GeofenceRequestConstants.EXIT_GEOFENCE_CONVERSION

2. 地理围栏配置缺失有效期参数 #

你当前定义的geofence对象未配置validDuration属性，该参数默认值为单次触发后失效，也会导致仅能收到首次回调。
修复代码：

const geofence = {
        latitude: latitude,
        longitude: longitude,
        radius: radius,
        uniqueId: identifier,
        conversions:
          HMSLocation.Geofence.Native.GeofenceConstants.ENTER_GEOFENCE_CONVERSION |
          HMSLocation.Geofence.Native.GeofenceConstants.EXIT_GEOFENCE_CONVERSION,
        validDuration: 365 * 24 * 60 * 60 * 1000 // 按需求设置有效期，单位毫秒，示例为1年
      }
geofenceList.push(geofence)

3. 重复注册围栏导致冲突 #

你当前的startGeofencingTask方法每次执行时都会用同一个GEOFENCING_TASK_ID创建新的围栏列表，未先移除旧的围栏列表，多次调用后会导致SDK内部触发逻辑异常。
修复方法：每次创建围栏列表前先调用删除接口清理旧数据：

// 在createGeofenceList前增加删除逻辑
try {
  await HMSLocation.Geofence.Native.deleteGeofenceList(GEOFENCING_TASK_ID)
} catch (e) {
  // 首次调用无旧围栏时可忽略该异常
}
// 再执行后续创建逻辑
HMSLocation.Geofence.Native.createGeofenceList(GEOFENCING_TASK_ID, geofenceList, conversionType, coordinateType)

4. 事件回调异常导致监听被销毁 #

检查huaweiGeofencingTask回调函数内部是否有未捕获的异常，如果回调执行时抛出未处理的错误，HMS SDK会自动注销对应的事件监听，导致后续无法收到回调。
修复方法：给回调逻辑增加全局异常捕获：

const huaweiGeofencingTask = async (event) => {
  try {
    // 原有业务逻辑
  } catch (e) {
    console.error('地理围栏回调处理异常', e)
  }
}

5. 动态权限与系统限制检查 #

• 仅在Manifest配置权限不生效，Android 10及以上版本需要动态申请ACCESS_BACKGROUND_LOCATION权限，Android 12及以上还需要确认用户授予的是精确定位权限，而非模糊定位权限
• 华为设备需要将应用加入电池优化白名单、允许后台活动，否则应用退到后台后进程被系统回收，无法接收围栏回调
• 确认设备的位置信息开关处于开启状态，且定位模式设置为高精度模式

6. 监听注册顺序与时机调整 #

你当前的监听注册在围栏创建之后，可能存在围栏已经触发但监听还未注册的问题，调整顺序先注册监听再创建围栏：

// 先注册监听
HMSLocation.Geofence.Events.registerGeofenceHeadlessTask(huaweiGeofencingTask)
HMSLocation.Geofence.Events.addGeofenceEventListener(huaweiGeofencingTask)
// 再创建围栏列表
HMSLocation.Geofence.Native.createGeofenceList(GEOFENCING_TASK_ID, geofenceList, conversionType, coordinateType)

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