Android 模擬器斷線與 Activity 未註冊導致 ClassNotFoundException

錯誤現象

運行應用時出現 ClassNotFoundException，Logcat 顯示 timeout、模擬器離線。

兩大核心原因與解決

1. 模擬器斷線/超時：
   • 重啟模擬器：adb kill-server && adb start-server，或 AVD Manager 中 Cold Boot Now。
   • 檢查電腦記憶體是否足夠，關閉其他重度應用騰出資源給模擬器。
   • 使用實體機除錯（開啟 USB 偵錯）避免模擬器不穩定。
2. Activity 未在 Manifest 註冊：
   • 檢查 AndroidManifest.xml，確認所有 Activity、Service、Receiver 皆在 <application> 內宣告。
   • 常見遺漏：新建 Activity 後忘記加入 Manifest，或套用 Library 專案未合併 Manifest。
   • Android Studio 可右鍵 Activity 類別 → Refactor > Add to Manifest 自動補全。

快速驗證清單

<application ...>
    <activity android:name=".MainActivity"> <!-- 必須存在 -->
        <intent-filter>
            <action android:name="android.intent.action.MAIN" />
            <category android:name="android.intent.category.LAUNCHER" />
        </intent-filter>
    </activity>
    <activity android:name=".SecondActivity" /> <!-- 新增頁面務必加上 -->
</application>

進階除錯

• Logcat 過濾 ActivityManager 標籤，觀察 START u0 {cmp=...} 是否正確解析 ComponentName。
• Instant Run / Apply Changes 有時導致類別載入異常，嘗試 Build > Clean Project → Rebuild Project。