Android地理围栏（Geofence）失效，IntentService未被调用

我看到你遇到了Android地理围栏功能失效的核心问题——对应的IntentService完全没被触发。先把你提供的Manifest代码格式化出来方便查看：

<?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android="http://schemas.android.com/apk/res/android" package="pounya.id.location3">

<uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />

<application 
    android:allowBackup="true" 
    android:icon="@mipmap/ic_launcher" 
    android:label="@string/app_name" 
    android:roundIcon="@mipmap/ic_launcher_round" 
    android:supportsRtl="true" 
    android:theme="@style/AppTheme">

<meta-data...

结合我处理这类问题的经验，给你梳理几个最可能的原因和对应的解决办法：

1. 先检查IntentService的Manifest注册 #

这是最容易忽略的点！如果你的IntentService没有在Manifest里正确声明，系统根本找不到它去启动。另外Android 8.0之后对后台服务限制更严，注意注册格式：

<service
    android:name=".你自己的GeofenceIntentService类名"
    android:exported="false" />

android:exported="false"一定要加上，因为这个服务只给你的应用内部调用，不需要对外暴露，避免不必要的安全风险。

2. 确认PendingIntent的创建逻辑 #

地理围栏触发的关键是PendingIntent，如果这里有问题，事件根本传不到服务里：

• 标志位要选对：高版本Android（API 23+）推荐用FLAG_UPDATE_CURRENT | PendingIntent.FLAG_IMMUTABLE，不要用FLAG_CANCEL_CURRENT，否则会导致旧的PendingIntent被取消，新的又无法正确绑定；
• 保证PendingIntent唯一：如果多次创建相同请求码、相同Intent的PendingIntent，会被覆盖，导致触发失效。如果需要多个地理围栏，建议用不同的请求码区分。

正确的创建示例：

Intent intent = new Intent(context, YourGeofenceIntentService.class);
PendingIntent geofencePendingIntent = PendingIntent.getService(
        context,
        0, // 如果有多个地理围栏，这里可以用不同的请求码
        intent,
        PendingIntent.FLAG_UPDATE_CURRENT | PendingIntent.FLAG_IMMUTABLE
);

3. 权限是否足够？ #

别漏了后台定位权限！Android 10（API 29）及以上，仅仅有ACCESS_FINE_LOCATION是不够的，必须申请ACCESS_BACKGROUND_LOCATION才能在后台接收地理围栏事件：

• 先在Manifest里加权限：

  <uses-permission android:name="android.permission.ACCESS_BACKGROUND_LOCATION" />
  

• 然后在代码里动态申请这个权限，因为它属于危险权限，必须用户手动授权，不能只靠Manifest声明。

4. 地理围栏本身的设置是否合理 #

有时候不是服务的问题，是地理围栏根本没被正确添加或者参数不对：

• 半径别设太小：如果半径小于10米，GPS的精度可能达不到，导致无法触发；
• 触发条件要明确：确保你添加地理围栏时设置了需要的触发类型，比如GEOFENCE_TRANSITION_ENTER、GEOFENCE_TRANSITION_EXIT；
• 加个错误监听：调用addGeofences时一定要加上成功/失败回调，看看是不是地理围栏根本没添加成功：

  geofencingClient.addGeofences(geofencingRequest, geofencePendingIntent)
          .addOnSuccessListener(v -> Log.d("Geofence", "地理围栏添加成功"))
          .addOnFailureListener(e -> Log.e("Geofence", "添加失败：" + e.getMessage()));
  

5. 高版本系统的后台限制问题 #

Android 8.0之后，IntentService已经被标记为过时了，因为系统对后台服务启动做了严格限制，应用在后台时可能根本启动不了IntentService。这时候推荐改用JobIntentService或者WorkManager：

改用JobIntentService的示例： #

1. 继承JobIntentService：

public class GeofenceJobService extends JobIntentService {
    public static final int JOB_ID = 1001;

    // 静态方法用于启动任务
    public static void enqueueWork(Context context, Intent work) {
        enqueueWork(context, GeofenceJobService.class, JOB_ID, work);
    }

    @Override
    protected void onHandleWork(@NonNull Intent intent) {
        // 这里写原来IntentService里处理地理围栏事件的逻辑
        GeofencingEvent event = GeofencingEvent.fromIntent(intent);
        if (event.hasError()) {
            Log.e("Geofence", "事件错误：" + event.getErrorCode());
            return;
        }
        // 获取触发类型等信息
        int transition = event.getGeofenceTransition();
        // ...你的业务逻辑
    }
}

2. 在Manifest里注册：

<service
    android:name=".GeofenceJobService"
    android:permission="android.permission.BIND_JOB_SERVICE"
    android:exported="false" />

3. 创建PendingIntent时改为广播类型，然后在广播接收器里调用enqueueWork：

Intent intent = new Intent(context, GeofenceBroadcastReceiver.class);
PendingIntent pendingIntent = PendingIntent.getBroadcast(
        context,
        0,
        intent,
        PendingIntent.FLAG_UPDATE_CURRENT | PendingIntent.FLAG_IMMUTABLE
);

然后在广播接收器里：

public class GeofenceBroadcastReceiver extends BroadcastReceiver {
    @Override
    public void onReceive(Context context, Intent intent) {
        GeofenceJobService.enqueueWork(context, intent);
    }
}

6. 测试环境的坑 #

• 尽量用真实设备测试：模拟器的GPS模拟经常不稳定，容易出现触发不及时或者根本不触发的情况；
• 确保设备在有GPS信号的环境：室内GPS信号差，可能无法准确检测位置变化；
• 手动模拟位置：用Android Studio的"Emulator Controls"或者第三方工具模拟进入/离开地理围栏的位置，验证是否触发。

内容的提问来源于stack exchange，提问作者Shalahuddin Al-Ayyubbi