J2ME 真機運行常見故障排查清單（10 大核心問題）

模擬器跑得好，真機卻崩？這 10 個塊覆蓋 90% 真機故障

J2ME 開發最讓人頭大的就是「模擬器正常、真機掛掉」。本文總結實戰中遇到的 10 大核心問題，按發生頻率排序，附帶排查思路與預防措施，建議收藏作發布前自查清單。

1. 資源未列入 JAD
   圖片/數據文件放入 res/ 但忘在 JAD MIDlet-Jar-URL 對應的 JAR 中打包，或 Ant/構建腳本漏包。
   ✅ 檢查：解壓 JAR 確認資源存在，路徑大小寫匹配。
2. 圖片文件名大小寫不一致
   Windows 不區分大小寫，模擬器能載入 bg.PNG；Linux 內核手機區分大小寫，createImage("/bg.png") 找不到文件拋 IOException。
   ✅ 規範：統一小寫，代碼與文件名完全一致。
3. 項目名/包名含中文
   部分手機解析 JAD 中文屬性失敗，導致安裝包無法識別。
   ✅ 規範：所有標識符純 ASCII。
4. 構造函數非 public
   MIDlet 載入器需調用無參 public 構造函數，包私有/protected 會實例化失敗。
   ✅ 檢查：public MyMidlet()。
5. 內存溢出 (OOM)
   一次性載入過多圖片、大數組、未釋放引用。真機堆遠小於模擬器（如 200KB~1MB）。
   ✅ 對策：分批載入、用完置 null + System.gc()、圖片複用、避免大局部變量。
6. 未捕獲異常導致 MIDlet 靜默退出
   網絡、RMS、圖片解碼等操作拋出 Exception 未 try-catch，系統直接殺進程。
   ✅ 原則：所有 I/O 入口統一捕獲，記錄日誌，友好提示用戶。
7. 啟動時一次性載入過多資源
   startApp() 中載入所有關卡圖、音效，超過啟動超時限制被看門狗殺掉。
   ✅ 對策：異步載入、顯示進度條、分幀載入。
8. 使用手機不支持的 API (JSR)
   代碼調用 JSR 184/JSR 239 等可選包，目標手機未實現，ClassNotFoundException 或 NoClassDefFoundError。
   ✅ 檢查：發布前用 System.getProperty("microedition.profiles") 和 JSR 屬性動態檢測，優雅降級。
9. CLDC/MIDP 版本不匹配
   用了 MIDP 2.0 API (GameCanvas, Sprite) 卻部署到 MIDP 1.0 手機。
   ✅ 對策：構建多版本 JAR (見 NetBeans Configuration 文章)，或代碼中反射檢測版本分支。
10. 必須提供 JAD 文件才能安裝
    部分運營商定製機/老機型只認 JAD，直接發 JAR 無法安裝。
    ✅ 規範：發布包始終包含 JAD+JAR，JAD 中 MIDlet-Jar-Size 必須準確。

快速自查口訣

資源入包名小寫，構造公共防中文。
內存分批捕異常，啟動輕量查版本。
JSR動態查支持，JAD配齊裝真機。