Android重启无网络时地图加载及Location Service定位失败求助

一、问题根源分析 #

1. 开机自启动逻辑缺失：设备重启后服务虽启动，但未主动触发定位请求，也未恢复未完成的Trip状态
2. FusedLocationProvider无网适配不足：默认配置依赖网络辅助定位，纯GPS模式下参数未优化
3. GPS冷启动无容错机制：无网时GPS首次定位耗时较长，现有代码未处理等待与重试逻辑
4. 地图未配置离线加载：无网环境下无法获取在线地图瓦片，导致地图加载失败

二、核心技术要点 #

• 开机自启动触发：通过RECEIVE_BOOT_COMPLETED广播启动服务并恢复定位状态
• 纯GPS定位优化：调整LocationRequest参数，确保无网时仅依赖GPS模块工作
• 冷启动重试机制：监听GPS卫星状态，当信号充足时重新发起定位请求
• 离线地图支持：提前下载离线地图资源，初始化地图时优先加载离线瓦片
• 权限持久化保障：确保重启后定位权限、后台权限、通知权限仍处于有效状态

三、代码修改示例 #

1. 添加开机自启动广播接收器 #

创建BootCompletedReceiver.java：

public class BootCompletedReceiver extends BroadcastReceiver {
    @Override
    public void onReceive(Context context, Intent intent) {
        if (Intent.ACTION_BOOT_COMPLETED.equals(intent.getAction()) 
            || Intent.ACTION_QUICKBOOT_POWERON.equals(intent.getAction())) {
            
            SharedDB sharedDB = new SharedDB(context);
            // 检查未结束的Trip及定位请求状态
            if (sharedDB.isTripActive() && sharedDB.isLocationRequestEnabled()) {
                String tripId = sharedDB.getActiveTripId();
                Intent serviceIntent = new Intent(context, LocationUpdatesService.class);
                serviceIntent.putExtra("trip_id", tripId);
                
                // Android O及以上需启动前台服务
                if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.O) {
                    context.startForegroundService(serviceIntent);
                } else {
                    context.startService(serviceIntent);
                }
            }
        }
    }
}

在AndroidManifest.xml中注册接收器并添加权限：

<receiver
    android:name=".BootCompletedReceiver"
    android:enabled="true"
    android:exported="true">
    <intent-filter>
        <action android:name="android.intent.action.BOOT_COMPLETED" />
        <action android:name="android.intent.action.QUICKBOOT_POWERON" />
    </intent-filter>
</receiver>

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

2. 修改LocationUpdatesService关键逻辑 #

（1）优化LocationRequest适配无网GPS

private void createLocationRequest() {
    mLocationRequest = new LocationRequest();
    // 无网时延长GPS更新间隔，平衡定位精度与功耗
    mLocationRequest.setInterval(10000);
    mLocationRequest.setFastestInterval(5000);
    mLocationRequest.setPriority(Priority.PRIORITY_HIGH_ACCURACY);
    // 不强制等待高精度定位，加快首次定位速度
    mLocationRequest.setWaitForAccurateLocation(false);
    // 设置最小位移过滤无效波动
    mLocationRequest.setSmallestDisplacement(1);
}

（2）在onStartCommand中自动触发定位请求

public int onStartCommand(Intent intent, int flags, int startId) {
    Log.i(TAG, "Service started");
    try {
        boolean startedFromNotification = intent.getBooleanExtra(EXTRA_STARTED_FROM_NOTIFICATION, false);
        if (startedFromNotification) {
            removeLocationUpdates();
            stopSelf();
            return START_STICKY;
        }
        
        // 从Intent或本地存储获取trip_id
        String tripId = null;
        if (intent != null) {
            tripId = intent.getStringExtra("trip_id");
        }
        if (tripId == null) {
            tripId = new SharedDB(this).getActiveTripId();
        }
        
        // 主动触发定位请求（若状态允许）
        if (tripId != null && !tripId.isEmpty() && ExtraUtils.requestingLocationUpdates(this)) {
            requestLocationUpdates(tripId);
        }
    } catch (Exception ignored) {}
    
    return START_STICKY;
}

（3）添加GPS冷启动重试逻辑

private void getLastLocation() {
    try {
        mFusedLocationClient.getLastLocation().addOnCompleteListener(task -> {
            if (task.isSuccessful() && task.getResult() != null) {
                mLocation = task.getResult();
                sendLocationBroadcast(mLocation);
            } else {
                // 无缓存位置时主动发起定位
                if (ExtraUtils.requestingLocationUpdates(LocationUpdatesService.this)) {
                    String tripId = new SharedDB(LocationUpdatesService.this).getActiveTripId();
                    if (tripId != null) {
                        requestLocationUpdates(tripId);
                    }
                }
                // 监听GPS卫星状态，信号充足时重试
                startGpsStatusListener();
            }
        });
    } catch (SecurityException unlikely) {
        Log.e(TAG, "Lost location permission", unlikely);
    }
}

private void startGpsStatusListener() {
    LocationManager locationManager = (LocationManager) getSystemService(LOCATION_SERVICE);
    if (locationManager == null) return;
    
    GpsStatus.Listener gpsListener = gpsStatus -> {
        int satelliteCount = gpsStatus.getSatelliteCount();
        Log.d(TAG, "GPS satellite count: " + satelliteCount);
        // 卫星数量≥4时重新请求定位
        if (satelliteCount >= 4) {
            String tripId = new SharedDB(this).getActiveTripId();
            if (tripId != null) {
                requestLocationUpdates(tripId);
            }
            locationManager.removeGpsStatusListener(this::startGpsStatusListener);
        }
    };
    locationManager.addGpsStatusListener(gpsListener);
}

private void sendLocationBroadcast(Location location) {
    Intent intent = new Intent(ACTION_BROADCAST);
    intent.putExtra(EVENT, "location");
    intent.putExtra(EXTRA_LOCATION, location);
    LocalBroadcastManager.getInstance(this).sendBroadcast(intent);
}

3. 地图离线加载处理（以Google Maps为例） #

在TripMapsActivity中初始化地图时启用离线模式：

@Override
public void onMapReady(GoogleMap googleMap) {
    mMap = googleMap;
    // 启用离线地图支持
    mMap.setMapType(GoogleMap.MAP_TYPE_NORMAL);
    
    // 检查并加载已下载的离线区域
    mMap.getOfflineTileManager().listOfflineRegions().addOnSuccessListener(regions -> {
        if (!regions.isEmpty()) {
            mMap.setLatLngBoundsForCameraTarget(regions.get(0).getBounds());
        }
    });
    
    // 加载离线地图样式（可选）
    try {
        boolean styleLoaded = mMap.setMapStyle(
                MapStyleOptions.loadRawResourceStyle(this, R.raw.map_style_offline));
        if (!styleLoaded) {
            Log.e(TAG, "Offline map style load failed");
        }
    } catch (Resources.NotFoundException e) {
        Log.e(TAG, "Offline map style resource not found", e);
    }
}

四、额外注意事项 #

• 权限检查：Android 12+需动态申请POST_NOTIFICATIONS权限，确保前台服务能正常启动
• 电池优化豁免：引导用户将应用加入电池优化白名单，避免后台被系统强制杀死
• Trip状态持久化：将Trip的激活状态、trip_id存储在本地数据库或SharedPreferences，重启后可快速恢复
• 用户提示：在UI层显示GPS信号强度，无网时提示用户等待GPS定位完成

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