生成的JAR文件中JDBC驱动未找到问题求助

嘿，这个问题我太熟了！核心原因其实很直白：Eclipse默认导出的JAR只会打包你自己写的代码，不会把Maven依赖的第三方库（比如你的JDBC驱动）包含进去。虽然Oracle说JDBC4.0+能自动加载驱动，但前提是驱动JAR得在运行时的类路径里才行啊！

下面给你拆解原因，再说说怎么解决：

1. Eclipse运行和外部JAR运行的本质区别 #

在Eclipse里跑项目时，Eclipse会自动把你通过POM引入的JDBC驱动（比如ojdbc8.jar）加到项目的运行类路径里，JVM自然能找到驱动类并自动加载。但当你导出普通可执行JAR时，Eclipse只会打包你自己的代码文件，依赖的第三方JAR完全不会被放进去。这就导致你在外部运行JAR时，JVM的类路径里根本没JDBC驱动，自然就报错找不到了。

2. 快速验证类路径差异的小技巧 #

你可以在代码里加一行打印类路径的代码，对比Eclipse运行和外部JAR运行的输出，一眼就能看出问题：

System.out.println(System.getProperty("java.class.path"));

在Eclipse里跑的时候，你会看到输出里有JDBC驱动的路径；但外部运行JAR时，只会显示你导出的那个JAR的路径，完全看不到驱动JAR的影子。

3. 三种实用解决方案 #

针对你的Maven项目，推荐这几种靠谱的解决方式：

方案一：打包成“胖JAR”（把所有依赖都塞进去） #

用Maven的Shade插件，它能把你的代码和所有依赖（包括JDBC驱动）打包成一个独立的JAR，直接运行就行。在你的POM.xml里加这段配置：

<build>
    <plugins>
        <plugin>
            <groupId>org.apache.maven.plugins</groupId>
            <artifactId>maven-shade-plugin</artifactId>
            <version>3.2.4</version>
            <executions>
                <execution>
                    <phase>package</phase>
                    <goals>
                        <goal>shade</goal>
                    </goals>
                    <configuration>
                        <transformers>
                            <transformer implementation="org.apache.maven.plugins.shade.resource.ManifestResourceTransformer">
                                <!-- 这里替换成你自己的主类全路径，比如com.example.MyMain -->
                                <mainClass>your.package.path.YourMainClass</mainClass>
                            </transformer>
                        </transformers>
                    </configuration>
                </execution>
            </executions>
        </plugin>
    </plugins>
</build>

配置好后，在项目根目录执行mvn package，target目录下生成的JAR就是包含所有依赖的胖JAR，直接用java -jar your-jar-file.jar运行就没问题了。

方案二：手动指定类路径运行 #

如果你不想打包成胖JAR，也可以把JDBC驱动JAR和你导出的项目JAR放在同一个文件夹里，然后用命令行指定类路径运行：

• Linux/macOS用冒号分隔：

java -cp your-project.jar:ojdbc8.jar your.package.path.YourMainClass

• Windows用分号分隔：

java -cp your-project.jar;ojdbc8.jar your.package.path.YourMainClass

方案三：用Maven Assembly插件打包 #

和Shade插件类似，Assembly插件也能构建包含依赖的JAR，配置方式略有不同，你可以根据自己的习惯选择。

最后补个小提醒 #

虽然JDBC4.0+不用手动调用Class.forName()来加载驱动，但这一切的前提是驱动JAR在类路径里。如果驱动不在，自动加载机制根本触发不了，所以核心还是要保证运行时能找到驱动JAR。

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