JavaFX应用经jlink打包后无法加载ojdbc驱动，如何解决？

问题核心在于jlink仅支持打包模块化JAR，而部分版本的ojdbc驱动可能未包含module-info.class（即非模块化JAR），导致jlink打包时自动忽略它。以下是具体解决步骤：

1. 确认ojdbc的模块名称 #

如果ojdbc是自动模块（无module-info.class），它的模块名通常是JAR文件名去掉版本号和后缀，比如ojdbc11.jar的自动模块名为com.oracle.database.jdbc。你可以通过以下命令验证：

jar --describe-module --file path/to/ojdbc.jar

如果输出中包含automatic module name: xxx，则记下这个模块名。

2. 配置Maven的jlink插件 #

在你的pom.xml中，更新maven-jlink-plugin的配置，明确添加ojdbc模块，并确保依赖被纳入打包：

<plugin>
    <groupId>org.apache.maven.plugins</groupId>
    <artifactId>maven-jlink-plugin</artifactId>
    <version>3.3.0</version>
    <executions>
        <execution>
            <id>create-runtime-image</id>
            <goals>
                <goal>jlink</goal>
            </goals>
            <phase>package</phase>
        </execution>
    </executions>
    <configuration>
        <modulePath>
            <path>${project.build.directory}/modules</path>
        </modulePath>
        <modules>
            <module>你的主模块名</module>
            <module>com.oracle.database.jdbc</module> <!-- 替换为实际的ojdbc模块名 -->
        </modules>
        <outputDirectory>${project.build.directory}/jlink-image</outputDirectory>
        <includeRuntimeDependencies>true</includeRuntimeDependencies>
        <launcher>你的应用启动器名称=你的主模块名/主类全路径</launcher>
        <jlinkOptions>
            <jlinkOption>--add-modules</jlinkOption>
            <jlinkOption>com.oracle.database.jdbc</jlinkOption> <!-- 重复添加确保被包含 -->
            <jlinkOption>--strip-debug</jlinkOption>
            <jlinkOption>--compress=2</jlinkOption>
        </jlinkOptions>
    </configuration>
</plugin>

注意：

• 替换你的主模块名和主类全路径为实际值
• 确保ojdbc的Maven依赖scope为compile（默认即可，不要设为provided）

3. 手动添加模块描述符（可选，若自动模块方式失效） #

如果自动模块无法被jlink识别，可手动为ojdbc生成module-info.java：

1. 编写模块描述符示例：

module com.oracle.database.jdbc {
    exports oracle.jdbc;
    exports oracle.jdbc.driver;
    exports oracle.sql;
    requires java.sql;
    requires java.naming;
    requires java.transaction.xa;
    opens oracle.jdbc.internal to java.sql;
    opens oracle.sql to java.sql;
}

2. 编译这个文件：

javac --module-path path/to/jdk/jmods -d temp module-info.java

3. 将编译后的module-info.class添加到ojdbc JAR中：

jar --update --file path/to/ojdbc.jar -C temp module-info.class

之后再按步骤2重新配置jlink插件即可。

4. 验证打包结果 #

运行jlink生成的镜像中的启动脚本，测试数据库连接是否正常。如果仍报错，检查：

• 模块名是否正确
• jlink插件配置中是否包含了所有必要的依赖模块
• 主类中是否正确加载驱动（Java 9+可省略Class.forName，但显式加载有助于排查问题）

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