JavaFX模块化应用自定义JRE缺失JDBC DriverManager的解决求助

1. 确保自定义JRE包含必要模块 #

javax.management.InstanceAlreadyExistsException属于java.management模块，jlink打包自定义JRE时默认不会自动包含该模块，需显式添加。结合Maven的maven-jlink-plugin配置如下：

<plugin>
    <groupId>org.apache.maven.plugins</groupId>
    <artifactId>maven-jlink-plugin</artifactId>
    <version>3.1.0</version>
    <executions>
        <execution>
            <id>build-custom-jre</id>
            <goals>
                <goal>jlink</goal>
            </goals>
            <configuration>
                <modulePath>
                    <path>${project.build.directory}/modules</path>
                </modulePath>
                <!-- 显式添加所需模块 -->
                <addModules>
                    <module>你的主模块名称</module>
                    <module>java.management</module>
                    <module>java.sql</module>
                    <module>javax.sql</module>
                    <module>java.naming</module>
                </addModules>
                <outputDirectory>${project.build.directory}/custom-jre</outputDirectory>
                <stripDebug>true</stripDebug>
                <compress>2</compress>
            </configuration>
        </execution>
    </executions>
</plugin>

2. 正确配置ojdbc17的模块化依赖 #

ojdbc17是模块化驱动，模块名为oracle.jdbc，需在应用的module-info.java中声明依赖：

module 你的主模块名称 {
    // JavaFX相关依赖
    requires javafx.controls;
    requires javafx.fxml;
    // Oracle JDBC驱动依赖
    requires oracle.jdbc;
    // JDBC核心API依赖
    requires java.sql;
    requires javax.sql;
    // JMX相关依赖
    requires java.management;
}

同时，用maven-dependency-plugin将ojdbc17等依赖jar复制到模块目录，供jlink读取：

<plugin>
    <groupId>org.apache.maven.plugins</groupId>
    <artifactId>maven-dependency-plugin</artifactId>
    <version>3.2.0</version>
    <executions>
        <execution>
            <id>copy-runtime-modules</id>
            <phase>package</phase>
            <goals>
                <goal>copy-dependencies</goal>
            </goals>
            <configuration>
                <outputDirectory>${project.build.directory}/modules</outputDirectory>
                <includeScope>runtime</includeScope>
            </configuration>
        </execution>
    </executions>
</plugin>

3. 验证DriverManager驱动加载 #

• 确保ojdbc17模块中已声明provides java.sql.Driver with oracle.jdbc.OracleDriver（官方版本已包含该声明），自定义JRE包含该模块后，DriverManager可自动发现驱动，无需手动调用Class.forName。
• 若仍需手动加载，确认模块依赖正确后，Class.forName("oracle.jdbc.OracleDriver")可正常执行，不会出现类找不到的问题。

4. 额外检查项 #

• 确认使用的ojdbc17为最新稳定版本（如21c或19c的补丁版），旧版本可能存在模块化兼容问题。
• 生成自定义JRE后，执行${project.build.directory}/custom-jre/bin/java --list-modules，检查java.management和oracle.jdbc是否在模块列表中。

是否需要更换数据库连接方式？ #

无需更换。JDBC在模块化JavaFX应用中可正常工作，只要正确配置模块依赖和自定义JRE即可。若后续想简化配置，可使用Spring JDBC、MyBatis等框架，但仍需依赖JDBC驱动，核心模块配置逻辑不变。

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