JavaFX调用Selenium时出现NoClassDefFoundError问题求助

我编写了两个Java文件：Main.java（JavaFX程序）和Test.java（包含Selenium代码）。单独运行Test.java一切正常，但点击JavaFX界面的按钮创建Test实例时，抛出java.lang.NoClassDefFoundError: org/openqa/selenium/WebDriver异常。已确认所有JAR文件位置正确，精简代码后问题仍存在，想知道原因。

相关代码 #

Main.java #

package application;
    
import java.io.IOException;

import javafx.application.Application;
import javafx.stage.Stage;
import javafx.scene.Scene;
import javafx.scene.control.Button;
import javafx.scene.layout.GridPane;


public class Main extends Application {
    @Override
    public void start(Stage primaryStage) throws IOException {
        Button runButton = new Button("Run");

        runButton.setOnAction(e -> {
            Test test = new Test();
        });
        
        GridPane GridBox = new GridPane();
        
        GridBox.add(runButton, 0, 0);

        Scene Scene = new Scene(GridBox, 380, 150);
        
        primaryStage.setScene(Scene);
        primaryStage.show();
    }
    
    public static void main(String[] args) {
        launch(args);
    }
}

Test.java #

package application;

import org.openqa.selenium.WebDriver;
import org.openqa.selenium.chrome.ChromeDriver;

public class Test {
    WebDriver driver;
    
    public static void main(String[] args) {
        Test obj = new Test();
        obj.setupWebsite();
    }
    
    public void setupWebsite() {
        // 创建Chrome窗口
        driver = new ChromeDriver();
        
        // 最大化窗口并打开谷歌网站
        driver.manage().window().maximize();
        driver.get("https://www.google.com");
    }
}

异常信息 #

Exception in thread "JavaFX Application Thread" java.lang.NoClassDefFoundError: org/openqa/selenium/WebDriver
    at application.Main.lambda$0(Main.java:18)
    ...（省略部分栈信息）
Caused by: java.lang.ClassNotFoundException: org.openqa.selenium.WebDriver
    at java.base/jdk.internal.loader.BuiltinClassLoader.loadClass(BuiltinClassLoader.java:641)
    ... 46 more

核心原因 #

这是类路径（Classpath）配置不一致导致的：单独运行Test.java时，IDE会自动把Selenium相关JAR加入类路径；但运行JavaFX程序时，类路径没有包含这些依赖JAR，JavaFX的类加载器找不到Selenium的类，从而抛出异常。

解决步骤 #

1. 检查IDE的运行配置 #

• 打开IDE中Main.java的运行配置（Run Configuration）
• 在「类路径」或「依赖」标签页，确认Selenium相关JAR包（如selenium-java.jar、ChromeDriver对应依赖等）已添加到类路径
• 若未添加，手动选中这些JAR文件加入配置

2. 用构建工具管理依赖（推荐） #

如果用Maven或Gradle，直接在配置文件中添加Selenium依赖，构建工具会自动处理类路径问题：

• Maven（pom.xml）：

  <dependency>
      <groupId>org.seleniumhq.selenium</groupId>
      <artifactId>selenium-java</artifactId>
      <version>你的Selenium版本号</version>
  </dependency>
  

3. 命令行运行时手动指定类路径 #

如果用命令行启动JavaFX程序，需要在命令中明确包含所有依赖JAR：

java --module-path "javafx-sdk/lib" --add-modules javafx.controls,javafx.fxml -cp ".;path/to/selenium/jars/*" application.Main

替换path/to/selenium/jars为你实际存放Selenium JAR的目录。

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