解決 Eclipse「Access restriction: The type 'Application' is not API」錯誤

解決 Eclipse「Access restriction: The type 'Application' is not API」錯誤

在 Eclipse 開發 JavaFX 專案時，引入 javafx.application.Application 可能出現以下編譯錯誤：

Access restriction: The type 'Application' is not API (restriction on required library '.../jre/lib/ext/jfxrt.jar')

原因

Eclipse 預設限制存取 JDK 內部非公開 API（jfxrt.jar 屬於擴展庫），導致無法正常引用 JavaFX 類別。

解決步驟

1. 右鍵專案 → Properties
2. 左側選單選擇 Java Build Path → Libraries 分頁
3. 找到 JRE System Library → 點擊 Remove 移除
4. 點擊 Add Library... → 選擇 JRE System Library → Next
5. 選擇 Workspace default JRE 或 Alternate JRE 指向已安裝的 JDK → Finish
6. Apply and Close，專案重新建置即可解決

原理說明

重新加入 JRE System Library 會重置存取規則，移除對 jfxrt.jar 的限制，使 JavaFX 公開 API 可正常被專案引用。

補充建議

• 若使用 Maven/Gradle 專案，建議改以 org.openjfx:javafx-controls 等模組依賴管理 JavaFX，避免相容性問題
• JDK 11 起 JavaFX 已從 JDK 移出，務必顯式宣告依賴