百度地圖 SDKInitializer NoClassDefFoundError 排查清單

錯誤：java.lang.NoClassDefFoundError: com.baidu.mapapi.SDKInitializer

核心檢查項

1. Jar/AAR 依賴是否正確導入：BaiduLBS_Android.jar、libs/armeabi*/libBaiduMapSDK.so。
2. Module 依賴關係：Library 模組需 api 而非 implementation 導出傳遞性依賴。
3. MultiDex 問題：方法數超 65k 需啟用 multiDexEnabled true 並安裝 MultiDex.install(this)。
4. Application 類別：SDKInitializer.initialize() 必須在 Application.onCreate() 最早呼叫，且進程判斷正確。
5. ProGuard 混淆：需保留 -keep class com.baidu.mapapi.** { *; }。

快速定位

// Build -> Analyze APK -> 搜尋 SDKInitializer.class
// 若不在 classes.dex，即為打包遺漏

建議

優先檢查 build.gradle 依賴配置與 Application 初始化順序，90% 情況為依賴傳遞或 MultiDex 未配置導致。