JavaFX与Jnetpcap项目启动报错：Exception in Application start method

问题背景 #

我正在用JavaFX和Jnetpcap开发数据通信检测项目，过程中先后处理了JRE库配置、新版JavaFX缺失jar包（创建自定义库解决）、错误过多后重建项目等问题，还在运行配置的VM参数中添加了 --module-path "my link" --add-modules=javafx.controls,javafx.fxml。但启动项目时仍报错，核心错误栈如下：

Exception in Application start method
java.lang.reflect.InvocationTargetException
    at java.base/jdk.internal.reflect.DirectMethodHandleAccessor.invoke(DirectMethodHandleAccessor.java:118)
    at java.base/java.lang.reflect.Method.invoke(Method.java:580)
    at javafx.graphics@21/com.sun.javafx.application.LauncherImpl.launchApplicationWithArgs(LauncherImpl.java:464)
    at javafx.graphics@21/com.sun.javafx.application.LauncherImpl.launchApplication(LauncherImpl.java:364)
    at java.base/jdk.internal.reflect.DirectMethodHandleAccessor.invoke(DirectMethodHandleAccessor.java:103)
    at java.base/java.lang.reflect.Method.invoke(Method.java:580)
    at java.base/sun.launcher.LauncherHelper$FXHelper.main(LauncherHelper.java:1135)
Caused by: java.lang.RuntimeException: Exception in Application start method
    at javafx.graphics@21/com.sun.javafx.application.LauncherImpl.launchApplication1(LauncherImpl.java:893)
    at javafx.graphics@21/com.sun.javafx.application.LauncherImpl.lambda$launchApplication$2(LauncherImpl.java:196)
    at java.base/java.lang.Thread.run(Thread.java:1583)
Caused by: java.lang.NoClassDefFoundError: org/jnetpcap/Pcap
    at controller.Controller.initialize(Controller.java:37)
    at javafx.fxml@21/javafx.fxml.FXMLLoader.loadImpl(FXMLLoader.java:2670)
    at javafx.fxml@21/javafx.fxml.FXMLLoader.loadImpl(FXMLLoader.java:2563)
    at javafx.fxml@21/javafx.fxml.FXMLLoader.load(FXMLLoader.java:2531)
    at controller.Main.setLayout(Main.java:31)
    at controller.Main.start(Main.java:24)
    at javafx.graphics@21/com.sun.javafx.application.LauncherImpl.lambda$launchApplication1$9(LauncherImpl.java:839)
    at javafx.graphics@21/com.sun.javafx.application.PlatformImpl.lambda$runAndWait$12(PlatformImpl.java:483)
    at javafx.graphics@21/com.sun.javafx.application.PlatformImpl.lambda$runLater$10(PlatformImpl.java:456)
    at java.base/java.security.AccessController.doPrivileged(AccessController.java:400)
    at javafx.graphics@21/com.sun.javafx.application.PlatformImpl.lambda$runLater$11(PlatformImpl.java:455)
    at javafx.graphics@21/com.sun.glass.ui.InvokeLaterDispatcher$Future.run(InvokeLaterDispatcher.java:95)
    at javafx.graphics@21/com.sun.glass.ui.win.WinApplication._runLoop(Native Method)
    at javafx.graphics@21/com.sun.glass.ui.win.WinApplication.lambda$runLoop$3(WinApplication.java:185)
    ... 1 more
Caused by: java.lang.ClassNotFoundException: org.jnetpcap.Pcap
    at java.base/jdk.internal.loader.BuiltinClassLoader.loadClass(BuiltinClassLoader.java:641)
    at java.base/jdk.internal.loader.ClassLoaders$AppClassLoader.loadClass(ClassLoaders.java:188)
    at java.base/java.lang.ClassLoader.loadClass(ClassLoader.java:526)
    ... 15 more
Exception running application controller.Main

解决步骤 #

1. 确认Jnetpcap库已正确加入项目依赖 #

• 检查项目依赖配置：比如IDEA的Project Structure -> Libraries，Eclipse的Build Path -> Libraries，确保jnetpcap.jar已经被添加到项目中。
• 若用Maven/Gradle，手动配置本地依赖（Jnetpcap不在Maven中央仓库），比如Maven可以在pom.xml中添加：

  <dependency>
      <groupId>org.jnetpcap</groupId>
      <artifactId>jnetpcap</artifactId>
      <version>1.4.r1425</version>
      <scope>system</scope>
      <systemPath>${project.basedir}/lib/jnetpcap.jar</systemPath>
  </dependency>
  

2. 配置Jnetpcap Native库路径 #

Jnetpcap依赖本地Native库（Windows下是jnetpcap.dll，Linux是.so，macOS是.dylib），必须让JVM能找到这些文件：

• 方案一：把Native库文件放到项目的src/main/resources目录，或者直接复制到JRE的bin目录（不推荐，环境耦合度高）。
• 方案二：在VM参数中添加Native库路径，和JavaFX的参数合并后示例：

  --module-path "你的JavaFX库路径" --add-modules=javafx.controls,javafx.fxml -Djava.library.path="Jnetpcap Native库所在的绝对路径"
  

3. 验证版本兼容性 #

• 确认Jnetpcap版本支持当前Java版本（比如Java 21），建议用最新稳定版（如jnetpcap-1.4.r1425）。
• 注意Jnetpcap分32位和64位版本，必须和你的JVM架构一致（比如64位Java配64位Native库）。

4. 清理重建项目 #

• 清理编译缓存：IDEA执行Build -> Clean Project，Eclipse执行Project -> Clean。
• 重新添加所有依赖（JavaFX和Jnetpcap），避免重建项目时遗漏配置。

5. 模块化项目额外配置 #

如果项目是模块化（有module-info.java），需要在文件中添加Jnetpcap的依赖声明：

module your.module.name {
    requires javafx.controls;
    requires javafx.fxml;
    requires jnetpcap; // 自动模块名对应jar包名称
}

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