Android 開發過程中常遇到的經典錯誤與解決方案整理，涵蓋權限配置、Activity 宣告、API 版本差異、Layout 載入、建置錯誤、Intent 參數混淆、SD 卡寫入權限、UI 佈局技巧、軟鍵盤處理、ScrollView 使用等 11 大類問題。

1. 網路權限被拒：Permission denied (missing internet permission)

在 AndroidManifest.xml 的 </application> 之後添加：

<uses-permission android:name="android.permission.INTERNET" />

2. 找不到 Activity 類：ActivityNotFoundException

在 Manifest 中宣告 Activity：

<activity android:name=".xxxActivity">
</activity>

3. startSubActivity 方法不存在

已棄用，請改用 startActivityForResult()

4. XML View 載入空指針：NullPointerException

忘記在 Activity 中載入 Layout：

setContentView(R.layout.main);

5. Unparsed aapt error 無法解析

執行選單：Project → Clean 通常可解決

6. requestCode 與 resultCode 混淆

• startActivityForResult(Intent, requestCode)：requestCode ≥ 0，用於識別回傳來源
• setResult(resultCode, Intent)：resultCode 識別執行結果（常用 RESULT_OK）
• onActivityResult(requestCode, resultCode, Intent)：三參數對應處理
• 多子模組時務必區分不同 requestCode

7. 無法下載檔案至 SD 卡

Manifest 添加權限：

<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />

8. 控件在父容器垂直置中

android:layout_gravity="center_vertical"

9. 同一行兩控件兩端對齊

使用 RelativeLayout，左側控件預設靠左，右側控件設 android:layout_alignParentRight="true"

<ImageView android:layout_alignParentRight="true" ... />

10. 軟鍵盤彈出擠壓佈局解決方案

在 Manifest 對應 Activity 添加：

android:windowSoftInputMode="adjustPan"

或固定佈局高度避免被壓縮

11. 佈局中使用 ScrollView 實現滾動

用 <ScrollView> 包裹原有佈局：

<ScrollView xmlns:android="..."
    android:layout_width="fill_parent"
    android:layout_height="wrap_content"
    android:scrollbars="none">
    ...原有佈局...
</ScrollView>

開發心得

• 善用 Logcat 除錯，錯誤堆疊資訊是關鍵
• 官方文檔與開發者指南是最權威參考
• 版本碎片化嚴重，測試需覆蓋多 API Level
• 優先使用 Support Library 確保相容性