解決 Eclipse 中 com.sun.image.codec.jpeg 包訪問受限問題

解決 Eclipse 中 com.sun.image.codec.jpeg 包訪問受限問題

在 Eclipse 中使用 com.sun.image.codec.jpeg.JPEGCodec 和 JPEGImageEncoder 處理圖片時，編輯器報錯：

Access restriction: The type JPEGImageEncoder is not accessible due to restriction on required library C:\Java\jre1.6.0_07\lib\rt.jar

原因分析

com.sun.* 包屬於 Sun/Oracle 內部實現 API，非標準公共 API。Eclipse 默認將此類受訪問限制的 API 設置為 ERROR 級別，阻止編譯通過。

解決方案：調整編譯器錯誤級別

1. 打開 Window → Preferences
2. 導航至 Java → Compiler → Errors/Warnings
3. 展開 Deprecated and restricted API
4. 將 Forbidden references (access rules) 從 Error 改為 Warning 或 Ignore
5. 點擊 Apply and Close，項目自動重新構建，錯誤消失

最佳實踐建議

• 優先使用標準 API：推薦使用 javax.imageio.ImageIO 配合 ImageWriter 進行 JPEG 編碼，避免依賴內部實現。
• 若必須使用內部 API，建議在模塊級別通過 @SuppressWarnings("restriction") 精確抑制警告，而非全局降級。
• JDK 9+ 模組化後，內部 API 默認強封裝，需通過 --add-exports 顯式開放，遷移成本更高。

// 推薦的標準寫法
BufferedImage image = ...;
ImageIO.write(image, "jpg", new File("output.jpg"));