Android项目添加Map Box依赖后出现Picasso报错,如何排查解决?
排查与解决方案
核心冲突本质是Mapbox系列依赖的传递依赖和你项目现有依赖出现了同名类引用错配、版本不匹配:Mapbox导航UI模块会自动拉取Picasso做导航界面的资源加载,Picasso本身定义了com.squareup.picasso.Callback类,和你项目里Retrofit的retrofit2.Callback类重名,加上传递依赖拉取的Picasso版本不全,就会触发连带的类找不到报错,只要不引入Mapbox依赖,Picasso类路径正常加载就不会触发问题。
第一步 先定位冲突来源
- 在项目终端执行依赖分析命令
./gradlew app:dependencies,搜索输出结果里的com.squareup.picasso条目,确认是哪个Mapbox模块拉进来的Picasso版本、是否存在版本不一致的情况。 - 常见触发逻辑:Mapbox 0.27.0版本的navigation-ui模块传递依赖了未适配完整的Picasso 2.5版本,这个旧版本缺少部分工具类,同时传递依赖的Retrofit旧版和你项目里的Retrofit版本不匹配,两个重名的Callback类会打乱编译器的类加载顺序,连带把Picasso的类引用全部标记为错误。
可直接落地的修复步骤
1. 统一全局Picasso版本
- 在app模块的
build.gradle的dependencies块最前面,显式声明Mapbox官方适配的Picasso稳定版本,强制覆盖所有传递依赖拉取的旧版Picasso:
// 放在dependencies开头,优先加载这个版本的Picasso implementation 'com.squareup.picasso:picasso:2.71828'
- 这个版本包含完整的
Callback、LruCache工具类,和Mapbox 0.27.x系列的导航UI模块完全适配,不会出现类缺失的报错。
2. 解决重名Callback的编译混淆
- 你写的逆地理编码逻辑本身没有问题,出现报错是因为类加载顺序混乱导致编译器把Retrofit的Callback和Picasso的Callback搞混了。
- 可以在匿名回调的声明上直接写全Retrofit的类全路径,彻底消弭重名导致的匹配错误:
// 把原来的new Callback<GeocodingResponse>()替换成全路径声明 client.enqueueCall(new retrofit2.Callback<GeocodingResponse>() { @Override public void onResponse(retrofit2.Call<GeocodingResponse> call, retrofit2.Response<GeocodingResponse> response) { // 原有业务逻辑完全不用改 } @Override public void onFailure(retrofit2.Call<GeocodingResponse> call, Throwable throwable) { // 原有业务逻辑完全不用改 } });
- 改完之后编译器会直接定位到你需要的Retrofit回调类,不会再误匹配Picasso的重名类,连带解决Picasso相关的报错。
3. 排除冗余的传递依赖
如果上面两步做完还有冲突,可以直接在Mapbox的navigation-ui依赖块里排除它自动拉取的旧版Picasso和Retrofit,再用你自己统一引入的版本做全局覆盖:
implementation ('com.mapbox.mapboxsdk:mapbox-android-navigation-ui:0.27.0') { transitive = true // 排除内部拉取的旧版依赖,避免版本错配 exclude group: 'com.squareup.picasso', module: 'picasso' exclude group: 'com.squareup.retrofit2', module: 'retrofit' }
4. 兜底的编译配置
如果还是出现类加载顺序导致的奇怪报错,可以在app模块的android配置块里加全局排除规则,统一管理Picasso的依赖版本:
android { // 原有其他android配置保持不变 configurations.all { exclude group: 'com.squareup.picasso', module: 'picasso' } }
补充说明:你当前使用的Mapbox SDK 7.0.0 + 导航模块0.27.0是2019年的旧版本,本身对新版Gradle、AndroidX的适配就存在不少传递依赖的遗留问题,长期使用的话可以对齐Mapbox官方的最新适配版本,减少这类无意义的类冲突。
内容的提问来源于stack exchange,提问作者Yeshan Santhush
相关产品推荐
相关产品推荐

