地理围栏事件过渡类型始终为-1问题排查求助

针对你遇到的地理围栏过渡事件类型始终为-1的问题，结合你的代码和现状，以下是实用的排查方向：

1. 检查PendingIntent的可变性标志 #

你当前使用了PendingIntent.FLAG_IMMUTABLE，但Android 12（API 31）及以上版本中，地理围栏服务需要向PendingIntent绑定的Intent中写入过渡数据，IMMUTABLE标志会阻止系统修改Intent内容，导致过渡类型等数据无法传递。

建议修改PendingIntent的标志：

val geofencePendingIntent: PendingIntent by lazy {
    val intent = Intent(appContext, GeofenceBroadcastReceiver::class.java)
    // 针对API 31+使用FLAG_MUTABLE，兼容旧版本保留FLAG_UPDATE_CURRENT
    val flags = if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.S) {
        PendingIntent.FLAG_UPDATE_CURRENT or PendingIntent.FLAG_MUTABLE
    } else {
        PendingIntent.FLAG_UPDATE_CURRENT
    }
    PendingIntent.getBroadcast(appContext, 0, intent, flags)
}

2. 验证GeofencingRequest的构建逻辑 #

你代码中调用了getGeofencingRequest(geofence)但未提供实现，需确认该方法是否正确配置：

• 必须调用addGeofence(geofence)将创建的地理围栏添加到请求中
• 若设置了setInitialTrigger，确保其值符合业务需求（避免误设为非目标过渡类型）

示例正确的构建方式：

private fun getGeofencingRequest(geofence: Geofence): GeofencingRequest {
    return GeofencingRequest.Builder()
        .addGeofence(geofence)
        // 可选：按需设置初始触发逻辑
        // .setInitialTrigger(GeofencingRequest.INITIAL_TRIGGER_ENTER)
        .build()
}

3. 为BroadcastReceiver添加唯一Intent Action #

避免其他无关Intent触发Receiver导致GeofencingEvent.fromIntent()解析失败：

• 给PendingIntent的Intent设置自定义Action：

val intent = Intent(appContext, GeofenceBroadcastReceiver::class.java)
intent.action = "com.your.app.package.ACTION_GEOFENCE_TRANSITION" // 替换为你的包名

• 在Manifest中给Receiver添加对应Intent过滤器：

<receiver android:name=".GeofenceBroadcastReceiver">
    <intent-filter>
        <action android:name="com.your.app.package.ACTION_GEOFENCE_TRANSITION" />
    </intent-filter>
</receiver>

4. 调试Intent的Extra内容 #

在GeofenceBroadcastReceiver的onReceive方法中打印Intent的所有Extra，确认系统是否传递了地理围栏相关数据：

override fun onReceive(context: Context?, intent: Intent?) {
    if (!checkForNotificationUserChoice(context)) return
    // 打印Intent所有Extra
    intent?.extras?.let { extras ->
        extras.keySet().forEach { key ->
            Log.d(TAG, "Intent Extra: $key = ${extras[key]}")
        }
    }
    val geofencingEvent = GeofencingEvent.fromIntent(intent!!)
    // 后续逻辑...
}

如果日志中没有com.google.android.location.intent.extra.geofence等相关字段，说明系统未向Intent写入数据，需回到PendingIntent或地理围栏添加流程排查。

5. 检查Google Play服务版本兼容性 #

模拟器的Google Play服务版本更新可能引入兼容性问题，尝试：

• 更新模拟器的Google Play服务至最新版本
• 使用不同Android版本的模拟器测试（比如Android 11、12、13），确认是否为特定版本的问题

6. 确认PendingIntent的RequestCode唯一性 #

你当前使用的RequestCode为0，若应用中其他地方也使用相同RequestCode创建PendingIntent，可能导致当前地理围栏的PendingIntent被覆盖。尝试将RequestCode改为唯一值，比如基于地理围栏ID的哈希：

val requestCode = geofence.requestId.hashCode()
PendingIntent.getBroadcast(appContext, requestCode, intent, flags)

7. 二次确认位置权限状态 #

虽然你开启了“始终允许”，但仍需在运行时验证权限是否生效：

private fun checkLocationPermissions(context: Context): Boolean {
    val fineGranted = ContextCompat.checkSelfPermission(context, Manifest.permission.ACCESS_FINE_LOCATION) == PackageManager.PERMISSION_GRANTED
    val backgroundGranted = if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.Q) {
        ContextCompat.checkSelfPermission(context, Manifest.permission.ACCESS_BACKGROUND_LOCATION) == PackageManager.PERMISSION_GRANTED
    } else {
        true
    }
    return fineGranted && backgroundGranted
}

在添加地理围栏前调用该方法，确保权限完全生效。

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