原因:資源文件錯誤 (XML 語法、命名、引用) 導致 AAPT 編譯失敗,R 類無法生成。
排查步驟:
[a-z0-9_.],嚴禁大寫字母、中文、特殊符號File → Invalidate Caches / Restart現象:WARNING: Application does not specify an API level requirement!
修復:在 AndroidManifest.xml <manifest> 內添加:
<uses-sdk android:minSdkVersion="21" android:targetSdkVersion="34" />
原因:模擬器/設備存儲空間不足,或 APK 體積超過可用空間。
方案一:協載重裝 (適用於已安裝舊版)
Settings → Apps → 選中 App → Uninstall → 重新 Run
方案二:擴大模擬器分區 (通用)
-partition-size 512 (單位 MB)android { defaultConfig { javaCompileOptions { annotationProcessorOptions { arguments = ["room.schemaLocation": "$projectDir/schemas".toString()] } } } } (無關,僅示例)現象:Failed to install on device 'emulator-5554': timeout
修復:
Eclipse/AS: Window → Preferences → Android → DDMS → ADB connection time out (ms) 默認 5000 → 改為 20000 或更大
或命令行:adb kill-server && adb start-server 重置連接。
原因:Manifest 中啟動 Activity 名稱寫錯,或缺少 . 前綴。
正確寫法:
<activity android:name=".MainActivity"> <!-- 以點開頭,自動補全包名 -->
<intent-filter>
<action android:name="android.intent.action.MAIN" />
<category android:name="android.intent.category.LAUNCHER" />
</intent-filter>
</activity>
原因:Manifest 中缺少 LAUNCHER category。
修復:確保主 Activity 包含:
<category android:name="android.intent.category.LAUNCHER" />
修復:在 AndroidManifest.xml <manifest> 下添加:
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" /> <!-- Android 10+ 另需 requestLegacyExternalStorage 或 MediaStore -->
| 現象 | 可能原因 | 解決 |
|---|---|---|
| 資源引用 @drawable/xxx 找不到 | 文件名大寫/中文/資源未編譯 | 重命名小寫、Clean Rebuild |
| java.lang.OutOfMemoryError | 圖片過大/內存洩漏/模擬器 heap 小 | inSampleSize 壓縮、LeakCanary 排查、增大模擬器 RAM |
| NetworkOnMainThreadException | 主線程執行網絡請求 | 子線程/協程/Retrofit+RxJava |
| ClassNotFoundException: Didn't find class | MultiDex 未啟用/構建緩存/Instant Run 殘留 | 啟用 multiDexEnabled true、Clean、關閉 Instant Run |
| Duplicate class / 依賴衝突 | 多庫引用同一依賴不同版本 | Gradle dependencyInsight 排查、強制統一版本 (resolutionStrategy) |
| 簽名驗證失敗 / INSTALL_PARSE_FAILED_NO_CERTIFICATES | 未簽名/簽名文件損壞/密鑰庫路徑錯 | Build → Generate Signed Bundle/APK 重新簽名 |
package:mine 只看當前應用、level:error 只看錯誤Android 開發常見問題 90% 集中在資源編譯 (R 文件)、存儲權限演進、Manifest 配置、模擬器環境、依賴衝突。建立「報錯 → 定位模塊 → 查官方文檔/遷移指南 → 最小化復現 → 修復驗證」的排查閉環,比死記硬背方案更高效。保持工具鏈 (AGP, Gradle, SDK, Emulator) 更新,閱讀 Release Notes,能預防大量已知坑位。