使用Mapbox获取定位时出现GoogleApiClient未连接异常求助

首先咱们拆解下这个矛盾的异常：onConnected回调本来就是GoogleApiClient连接成功后才会触发的，但却抛出了“未连接”的提示，这大概率是代码里的异步逻辑、权限检查时机出了问题，或是Mapbox和Google位置服务的集成产生了冲突。下面给你几个针对性的解决思路：

1. 排查是否在onConnected外提前调用了依赖GoogleApiClient的方法 #

虽然异常指向onConnected方法，但很可能是其他地方的代码提前触发了需要GoogleApiClient处于连接状态的操作。比如：

• 有没有在onCreate/onStart里直接调用getLastLocation()这类方法？这些操作必须等GoogleApiClient完全连接后才能执行。
• 检查所有调用GoogleApiClient相关方法的位置，确保它们要么在onConnected回调之后执行，要么先判断连接状态：

if (googleApiClient != null && googleApiClient.isConnected()) {
    // 执行需要GoogleApiClient连接的操作，比如获取位置
}

2. 修正onConnected里的权限检查逻辑 #

你的异常行落在权限检查代码里，可能是权限通过后执行的操作触发了异常。先优化权限检查逻辑，确保权限完全授予后再执行位置相关操作：

@Override
public void onConnected(@Nullable Bundle bundle) {
    // 先确认位置权限是否授予
    if (ActivityCompat.checkSelfPermission(this, Manifest.permission.ACCESS_FINE_LOCATION) == PackageManager.PERMISSION_GRANTED) {
        // 权限通过后再执行位置操作
        // 如果用Google位置服务：
        LocationServices.FusedLocationApi.getLastLocation(googleApiClient);
        // 更推荐用Mapbox原生位置服务，避免和Google服务冲突
        MapboxLocationProvider mapboxLocationProvider = new MapboxLocationProvider(this);
        mapboxLocationProvider.requestLocationUpdates(new LocationCallback() {
            @Override
            public void onLocationResult(LocationResult locationResult) {
                if (locationResult.getLastLocation() != null) {
                    // 在Mapbox上添加当前位置标记
                    mapboxMap.addMarker(new MarkerOptions()
                            .position(new LatLng(locationResult.getLastLocation().getLatitude(), locationResult.getLastLocation().getLongitude()))
                            .title("当前位置"));
                }
            }
        });
    } else {
        // 权限未授予，发起权限请求
        ActivityCompat.requestPermissions(this, new String[]{Manifest.permission.ACCESS_FINE_LOCATION}, LOCATION_PERMISSION_REQUEST_CODE);
    }
}

3. 统一使用Mapbox原生位置服务，避免冲突 #

既然你用的是Mapbox，推荐直接用它官方的位置服务，不要混合Google的位置API，这样能彻底避免两者的状态冲突：

• 移除项目中Google Play Services位置相关的依赖（如果有的话）
• 使用Mapbox的LocationEngine来获取位置，示例代码如下：

// 初始化Mapbox位置引擎
LocationEngine locationEngine = LocationEngineProvider.getBestLocationEngine(this);
LocationEngineRequest request = new LocationEngineRequest.Builder(1000)
        .setPriority(LocationEngineRequest.PRIORITY_HIGH_ACCURACY)
        .build();

// 请求位置更新
if (ActivityCompat.checkSelfPermission(this, Manifest.permission.ACCESS_FINE_LOCATION) == PackageManager.PERMISSION_GRANTED) {
    locationEngine.requestLocationUpdates(request, new LocationEngineCallback<LocationEngineResult>() {
        @Override
        public void onSuccess(LocationEngineResult result) {
            Location location = result.getLastLocation();
            if (location != null) {
                // 添加当前位置标记
                LatLng currentLatLng = new LatLng(location.getLatitude(), location.getLongitude());
                mapboxMap.addMarker(new MarkerOptions().position(currentLatLng).title("我的位置"));
                // 移动地图到当前位置
                mapboxMap.moveCamera(CameraUpdateFactory.newLatLngZoom(currentLatLng, 15));
            }
        }

        @Override
        public void onFailure(@NonNull Exception exception) {
            Log.e(TAG, "位置获取失败: " + exception.getMessage());
        }
    }, Looper.getMainLooper());
}

4. 确保GoogleApiClient的生命周期管理正确 #

如果你确实需要保留GoogleApiClient，一定要严格管理它的生命周期：

• 在onStart()里调用googleApiClient.connect()
• 在onStop()里调用googleApiClient.disconnect()
• 在onDestroy()里销毁GoogleApiClient实例

这样能避免出现连接状态不一致的情况。

5. 避免onConnected重复回调触发异常 #

有时候onConnected可能会被多次回调，导致重复执行位置操作进而触发异常，可以添加标记位来控制：

private boolean isGoogleApiConnected = false;

@Override
public void onConnected(@Nullable Bundle bundle) {
    if (isGoogleApiConnected) {
        return;
    }
    isGoogleApiConnected = true;
    // 后续的权限检查和位置操作代码
}

@Override
public void onConnectionSuspended(int i) {
    isGoogleApiConnected = false;
}

按照上面的步骤排查修复，应该能解决这个异常问题。如果还有疑问，可以把完整的位置相关代码贴出来，我再帮你进一步分析。

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