Unity集成Mapbox SDK后Android APK构建失败求助

你的问题并非自身配置错误，核心原因是Mapbox Unity SDK 2.1.1版本过于老旧——它依赖的Android Support库（support-v4-25.1.0）与Unity 2022.x默认启用的AndroidX架构不兼容。Jetifier在尝试将Support库转换为AndroidX时，遇到了库中硬编码的android.support.v4字符串字面量，无法安全重写；同时依赖冲突引发了java.lang.StackOverflowError。

具体解决办法 #

方案1：给Jetifier添加黑名单跳过问题库 #

开启Custom Gradle Properties Template后，找到项目中的gradle.properties文件，添加以下配置：

android.jetifier.blacklist=support-v4-25.1.0

这会让Jetifier跳过对该库的转换，避免字面量重写失败的问题。

方案2：替换Support库为AndroidX依赖 #

1. 打开Custom Main Gradle Template文件，定位到dependencies代码块。
2. 在Mapbox相关依赖中排除旧Support库，同时引入对应的AndroidX替代库：

dependencies {
    // 排除Mapbox依赖的support-v4库
    implementation ('com.mapbox.mapboxsdk:mapbox-android-sdk:6.1.0') {
        exclude group: 'com.android.support', module: 'support-v4'
    }
    // 用AndroidX Core库替代support-v4
    implementation 'androidx.core:core:1.10.1'
    // 保留其他原有依赖
    ...
}

注：Mapbox Android SDK版本需与Unity SDK 2.1.1匹配，通常为6.1.0版本

方案3：升级Mapbox Unity SDK版本 #

最彻底的解决方式是升级到兼容AndroidX的Mapbox Unity SDK（3.x及以上版本），新版本已原生支持AndroidX，移除了对旧Support库的依赖，能从根源避免这类兼容性问题。升级前请确认版本与Unity 2022.3的兼容性。

方案4：清理缓存解决StackOverflowError #

若上述操作后仍出现栈溢出错误，执行以下步骤：

• 关闭Unity，删除项目根目录下的Library文件夹
• 重新打开Unity，等待项目缓存重新生成
• 再次尝试构建APK

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