解決 Eclipse/MyEclipse 中 com.sun.* 套件導入受限錯誤（Access Restriction）

com.sun.* 套件導入受限錯誤完整解決方案

錯誤現象

在 Eclipse/MyEclipse 中使用 com.sun.image.codec.jpeg.* 等 JDK 內部 API 時，編輯器報錯：

Access restriction: The type '...' is not API (restriction on required library 'rt.jar')

預設編譯器將其視為 Error，導致專案無法編譯通過。

根本原因

• com.sun.*、sun.* 等套件屬於 JDK 內部實現 API，非標準公開 API
• Oracle 明確建議不要直接使用，因其可能在版本間變更或移除
• Eclipse 編譯器預設將「禁止引用受限 API」設為 Error 級別

解決方案：調整編譯器警告等級

將「禁止引用受限 API」從 Error 降級為 Warning，即可編譯通過（但保留警告提醒風險）。

操作步驟（Eclipse / MyEclipse / STS 通用）

1. 開啟視窗：Window > Preferences (Mac: Eclipse > Preferences)
2. 導航至：Java > Compiler > Errors/Warnings
3. 展開 Deprecated and restricted API
4. 找到 Forbidden reference (access rules)
5. 將等級從 Error 改為 Warning（或 Ignore）
6. 點擊 Apply and Close，專案將自動重新建構

專案級別精準控制（推薦）

若不想全域生效，可針對單一專案設定：

1. 右鍵專案 > Properties > Java Compiler
2. 勾選 Enable project specific settings
3. 同樣調整 Errors/Warnings > Deprecated and restricted API

替代方案：使用標準 API 替代內部實現

最佳實踐建議

• 優先遷移至標準 API：長期專案務必替換內部 API，避免 JDK 升級導致不可預期故障
• 若必須使用：在程式碼加上 @SuppressWarnings("restriction") 並添加註釋說明原因
• 模組化系統 (JDK 9+)：內部 API 預設強封裝，需透過 --add-exports 才能存取，更應加速遷移

提醒：降級為 Warning 僅是暫時規避編譯錯誤，生產環境強烈建議替換為標準 API，確保長期維護性與跨 JDK 版本相容性。