JavaFX运行遇LinkageError/UnsupportedClassVersionError，求JRE适配方案

错误信息 #

Error: LinkageError occurred while loading main class LauncherPackage.StageManager
java.lang.UnsupportedClassVersionError: javafx/application/Application has been compiled by a more recent version of the Java Runtime (class file version 61.0), this version of the Java Runtime only recognizes class file versions up to 56.0

错误原因 #

class file version 61.0对应Java 17，56.0对应Java 12。问题核心是：项目运行依赖的JRE版本低于JavaFX SDK编译时使用的版本，导致低版本JRE无法识别高版本编译的JavaFX类文件。

解决步骤 #

• 确认本地JDK版本：打开命令提示符/终端，执行java -version和javac -version，确保版本为Java 17或更高。若版本不符，安装对应版本的JDK（OpenJDK或Oracle JDK均可）。
• 配置Eclipse项目的JRE：
  1. 右键项目 → 「Build Path」→ 「Configure Build Path」
  2. 在「Libraries」标签页，找到「JRE System Library」，若版本低于17，点击「Remove」删除
  3. 点击「Add Library」→ 选择「JRE System Library」→ 「Next」
  4. 选择「Alternate JRE」→ 点击「Installed JREs」→ 「Add」→ 选择「Standard VM」→ 定位到你安装的Java 17+的安装目录（如C:\Program Files\Java\jdk-17.0.9），完成配置后选中该JRE添加到项目
  5. 切换到「Java Compiler」标签页，将「Compiler compliance level」设置为与JRE版本一致（如17）
• 匹配JavaFX SDK版本：确保下载的JavaFX SDK版本和JDK版本完全一致（比如JDK 17对应JavaFX 17），避免版本混用。

你编写的代码 #

import javafx.application.Application;
import javafx.event.*;
import javafx.scene.Scene;
import javafx.scene.control.Button;
import javafx.scene.layout.StackPane;
import javafx.stage.Stage;

public class StageManager extends Application {

    private Stage primaryStage;
    
    private Button button;
    
    public static void main(String[] args) {
        // TODO Auto-generated method stub
        launch(args);
    }

    @Override
    public void start(Stage stageIn) throws Exception {
        // TODO Auto-generated method stub
        primaryStage = stageIn;
        primaryStage.setTitle("Title");
        button = new Button();
        button.setText("Click Me");
        
        StackPane layout = new StackPane();
        layout.getChildren().add(button);
        
        Scene scene = new Scene(layout, 300, 250);
        primaryStage.setScene(scene);
        primaryStage.show();
    }
}

内容的提问来源于stack exchange，提问作者fawfulsPikminArmy