You need to enable JavaScript to run this app. Android Studio集成Mapbox SDK出现依赖下载401未授权错误求助
优惠活动
大模型
产品
解决方案
定价
更多

Android Studio集成Mapbox SDK出现依赖下载401未授权错误求助

Mapbox SDK 依赖401授权错误排查方案

报错401 Unauthorized代表Mapbox Maven仓库的身份认证失败,可按以下步骤逐一排查:

  • 检查下载令牌权限是否正确
    你使用的MAPBOX_DOWNLOADS_TOKEN不能是前端用的公开访问令牌,必须是在Mapbox后台创建时勾选了DOWNLOADS:READ权限的私有令牌,令牌前缀为sk.。
  • 检查gradle.properties配置是否正确
    1. 确认gradle.properties放在项目根目录下,而非app模块目录内
    2. 确认键名拼写完全为MAPBOX_DOWNLOADS_TOKEN,无大小写、拼写错误
    3. 配置令牌时不要加任何引号,不要在等号前后加多余空格,格式为MAPBOX_DOWNLOADS_TOKEN=你的私有令牌完整内容
  • 检查仓库配置位置是否正确
    如果你使用的是Android Studio Arctic Fox及以上版本创建的新项目,默认仓库配置已从项目级build.gradle的allprojects块迁移到settings.gradle的dependencyResolutionManagement > repositories块中,你需要把Mapbox的Maven仓库配置移到settings.gradle的对应位置才能生效。
  • 验证令牌有效性
    可临时把配置中的password字段硬编码为你的完整私有令牌测试:
    password = "你的完整sk.开头的私有令牌"
    
    若硬编码后可以正常拉取依赖,说明之前的gradle.properties配置读取失败,可排查路径、拼写问题;若仍报错,说明令牌本身权限有误或已过期,需去Mapbox后台重新生成符合权限的令牌。
  • 清理缓存重试
    若以上配置均无误,可尝试清理Gradle缓存并重新同步:点击Android Studio菜单栏 File > Invalidate Caches,勾选清除文件系统缓存后重启IDE,再重新同步项目。

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

相关产品推荐
方舟 Agent Plan

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

最近更新时间:2026.10.18 03:06:03