You need to enable JavaScript to run this app.
优惠活动
大模型
产品
解决方案
定价
更多

Android Studio导入Mapbox SDK v10报Failed to resolve错误求助

Mapbox SDK v10 Gradle构建失败(Failed to resolve: com.mapbox.maps:android:10.0.0)解决方法

你遇到的报错如下:

Failed to resolve: com.mapbox.maps:android:10.0.0

按照以下步骤排查修改即可解决:

  • 第一步:配置正确的下载鉴权Token
    首先在Mapbox个人账号后台创建具备Downloads:Read权限的Secret Token,再将该Token写入项目根目录的gradle.properties文件中,格式如下:
    MAPBOX_DOWNLOADS_TOKEN=你创建的具备Downloads:Read权限的Secret Token
    
    注意不要给Token加引号,普通的公开调用Token没有下载私有仓库依赖的权限,必须单独创建带下载权限的Secret Token。
  • 第二步:修正仓库配置
    如果你使用的是Android Studio Arctic Fox及以上版本,默认全局仓库配置已经从根目录build.gradle的allprojects块迁移到了settings.gradle的dependencyResolutionManagement块中,你需要将Mapbox的maven仓库配置移到settings.gradle中,示例配置:
    dependencyResolutionManagement {
        repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
        repositories {
            google()
            mavenCentral()
            maven {
                url 'https://api.mapbox.com/downloads/v2/releases/maven'
                authentication {
                    basic(BasicAuthentication)
                }
                credentials {
                    username = 'mapbox'
                    password = project.properties['MAPBOX_DOWNLOADS_TOKEN'] ?: ""
                }
            }
        }
    }
    
    另外根目录build.gradle的buildscript块中不需要配置Mapbox的maven仓库,该块仅用于加载Gradle插件的依赖,可以直接删掉buildscript里的Mapbox仓库配置减少冗余。
  • 第三步:删除冲突依赖
    你当前的模块级build.gradle中同时引入了Mapbox v10和MapLibre的地图SDK,两者底层同源存在大量类冲突,必须删掉MapLibre的依赖行:
    // 删除这行配置
    implementation 'org.maplibre.gl:android-sdk:9.2.1'
    
  • 第四步:确认版本号并重新构建
    确认你使用的Mapbox版本号在官方maven仓库中存在,建议优先使用更高的稳定版而非早期的10.0.0版本。完成上述修改后,点击Android Studio菜单栏的File -> Invalidate Caches...,勾选清理缓存并重启IDE,之后重新同步Gradle。如果同步仍然失败,可检查当前网络是否能正常访问Mapbox服务,是否存在代理、防火墙拦截请求的情况。

内容的提问来源于stack exchange,提问作者Istorian

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.09.27 09:45:03