JavaFX应用经jpackage生成exe后无法连接PostgreSQL及启动异常

问题核心原因 #

手动添加--java-options "-cp lib/postgresql-42.6.0.jar"会覆盖jpackage默认生成的类路径，导致应用本身的jar被排除，因此出现ClassNotFoundException: application.Main；而不添加该参数时，驱动jar未被正确加载，所以数据库相关面板空白。

具体解决步骤 #

• 不要手动指定-cp参数
  jpackage打包时会自动读取配置文件里的app.classpath，手动添加-cp会覆盖默认类路径，把应用jar从类路径中移除，直接导致找不到主类。

• 确保依赖jar被正确纳入打包范围
  打包前将你的应用jar和postgresql-42.6.0.jar放到同一个目录（比如lib文件夹），然后在jpackage命令中指定--input lib，让jpackage自动将该目录下的所有jar加入类路径。示例打包命令：

  jpackage --name MyApp2 --input lib --main-jar myapp.jar --main-class application.Main --win-console
  

• 适配模块化/非模块化项目

  • 若为模块化项目（存在module-info.java），需在模块声明中添加对PostgreSQL驱动的依赖：

    module your.module.name {
        requires javafx.controls;
        requires javafx.fxml;
        requires org.postgresql.jdbc;
        exports application;
    }
    

  • 若为非模块化项目，打包时需通过--add-modules参数指定所需模块，确保驱动被加载：

    jpackage --name MyApp2 --input lib --main-jar myapp.jar --main-class application.Main --win-console --add-modules javafx.controls,javafx.fxml,org.postgresql.jdbc
    

• 优化数据库连接代码
  移除旧的Class.forName("org.postgresql.Driver")代码，JDBC 4.0+版本会自动读取驱动jar中META-INF/services/java.sql.Driver文件加载驱动，避免因类路径问题导致驱动加载失败。

• 验证配置文件类路径
  打包完成后，打开安装目录下的MyApp.cfg，确认app.classpath同时包含应用jar和驱动jar，格式如下：

  app.classpath=$APPDIR\lib\myapp.jar;$APPDIR\lib\postgresql-42.6.0.jar
  

  若路径缺失，重新检查打包时的--input参数是否指向正确的依赖目录。

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