Android项目集成Mapbox时出现mapbox-android-sdk依赖无法解析报错

报错根因 #

你的构建日志明确指向Gradle无法下载Mapbox依赖，可按照以下优先级逐一排查修复：

• 问题1：Gradle开启了离线模式，无法拉取未本地缓存的Mapbox依赖
  修复步骤：
  1. 打开Android Studio右侧边栏的Gradle面板，点击面板顶部的「Toggle Offline Mode」按钮（图标为带斜杠的WiFi标识），关闭离线模式后重新构建项目
  2. 若上述操作无效，检查项目根目录下的gradle.properties文件，删除org.gradle.offline=true配置项后重试
• 问题2：Mapbox下载令牌配置错误
  注意：你需要用到两个不同的Mapbox令牌，一个是代码中初始化用的公开访问令牌，另一个是下载依赖用的、带有DOWNLOADS:READ权限的专用下载令牌，二者不能混用
  修复步骤：
  1. 确认你从Mapbox账号后台生成的下载令牌已经开启DOWNLOADS:READ权限
  2. 打开项目根目录下的gradle.properties文件，添加配置MAPBOX_DOWNLOADS_TOKEN=你生成的带下载权限的令牌，注意令牌前后不要加引号
• 问题3：仓库配置位置不匹配新版本Android Studio规则
  若你使用的是Android Studio Arctic Fox及以上版本，项目默认将全局仓库统一配置在根目录的settings.gradle文件的dependencyResolutionManagement > repositories块中，你需要将Mapbox的maven仓库配置从项目级build.gradle移动到该块下，否则仓库配置不会生效
• 问题4：缓存异常导致配置不生效
  若以上配置都确认正确仍报错，点击Android Studio顶部菜单栏的File > Invalidate Caches...，勾选清空缓存并重启IDE，之后重新构建项目即可

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