Android 14定位类型前台服务启动崩溃问题排查求助

核心问题 #

你的报错源于API 34（targetSDK=34）下启动位置类型前台服务的权限检查逻辑不匹配系统要求，同时后台进程使用ActivityCompat.checkSelfPermission无法准确判断权限可用性：

1. 权限检查逻辑错误：
   API 34启动位置前台服务，不需要强制持有ACCESS_BACKGROUND_LOCATION，仅需持有前台位置权限（ACCESS_FINE_LOCATION或ACCESS_COARSE_LOCATION处于授权状态），且应用处于前台eligible状态。你的检查逻辑强制要求ACCESS_BACKGROUND_LOCATION，会导致两种错误：

   • 有前台位置权限但无后台权限时，检查不通过；
   • 有后台权限但应用当前不在前台时，不符合系统eligible状态要求，仍触发报错。

2. 权限检查方法不适配后台进程：
   调用进程为remote后台进程，ActivityCompat.checkSelfPermission仅判断权限是否被授予，无法区分应用当前是前台还是后台状态。而PermissionChecker.checkSelfPermission会结合应用运行状态判断权限是否可用，更适合后台场景。

3. 可能缺失Manifest权限声明：
   FOREGROUND_SERVICE_LOCATION是普通权限，无需动态申请，但必须在Manifest中声明，否则会触发权限校验失败。

可行解决方案 #

1. 修正权限检查逻辑，改用PermissionChecker #

更新权限检查方法，适配API 34的要求：

public static boolean checkLocationPermissionForForegroundService(Context context) {
    boolean hasFineLocation = PermissionChecker.checkSelfPermission(context, Manifest.permission.ACCESS_FINE_LOCATION) == PermissionChecker.PERMISSION_GRANTED;
    boolean hasCoarseLocation = PermissionChecker.checkSelfPermission(context, Manifest.permission.ACCESS_COARSE_LOCATION) == PermissionChecker.PERMISSION_GRANTED;

    if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.UPSIDE_DOWN_CAKE) {
        // API 34+：需要至少一种前台位置权限，且应用处于前台eligible状态
        return (hasFineLocation || hasCoarseLocation) && isAppInForegroundEligibleState(context);
    } else if (Build.VERSION.SDK_INT > Build.VERSION_CODES.P) {
        // API 29-33：若仅需前台定位，无需强制检查BACKGROUND_LOCATION
        return hasFineLocation || hasCoarseLocation;
    } else {
        return hasFineLocation;
    }
}

// 辅助判断应用是否处于前台eligible状态（API 34+要求）
private static boolean isAppInForegroundEligibleState(Context context) {
    ActivityManager am = (ActivityManager) context.getSystemService(Context.ACTIVITY_SERVICE);
    if (am == null) return false;

    List<ActivityManager.RunningAppProcessInfo> processes = am.getRunningAppProcesses();
    if (processes == null) return false;

    for (ActivityManager.RunningAppProcessInfo process : processes) {
        if (process.processName.equals(context.getPackageName()) 
            && process.importance == ActivityManager.RunningAppProcessInfo.IMPORTANCE_FOREGROUND) {
            return true;
        }
    }
    return false;
}

2. 确保Manifest声明完整权限 #

在AndroidManifest.xml中添加必要权限：

<!-- 前台服务位置类型权限 -->
<uses-permission android:name="android.permission.FOREGROUND_SERVICE_LOCATION" />
<!-- 基础位置权限 -->
<uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />
<uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION" />
<!-- 仅当需要后台定位时添加，API 34+前台服务不需要此权限 -->
<uses-permission android:name="android.permission.ACCESS_BACKGROUND_LOCATION" android:maxSdkVersion="33" />

3. 调整前台服务启动逻辑 #

替换原有的启动判断逻辑：

if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.UPSIDE_DOWN_CAKE) {
    if (Utils.checkLocationPermissionForForegroundService(this)) {
        ServiceCompat.startForeground(this, AUTO_ATTENDANCE_ID, 
            getNotification(getString(R.string.please_enable_gps), activityPendingIntent), 
            FOREGROUND_SERVICE_TYPE_LOCATION);
    } else {
        Utils.appendLog(TAG, "Location permissions or foreground eligibility denied for ASIOFS to start", this);
    }
} else {
    if (Utils.checkLocationPermission(this)) {
        startForeground(AUTO_ATTENDANCE_ID, getNotification(getString(R.string.please_enable_gps), activityPendingIntent));
    } else {
        Utils.appendLog(TAG, "Location permissions denied for ASIOFS to start", this);
    }
}

关键说明 #

• PermissionChecker.checkSelfPermission会结合应用的运行状态（前台/后台）判断权限是否可用，比ActivityCompat.checkSelfPermission更适合后台进程的权限校验场景。
• API 34+对位置型前台服务的限制更严格：应用必须处于前台可见状态（如存在可见Activity），或满足系统豁免条件，否则即使持有位置权限也无法启动前台服务。

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