打包成Jar文件后Derby嵌入式数据库连接失败求助

这个问题我之前也碰到过，核心原因很简单：Maven默认打包出来的Jar只包含你自己写的代码，不会把依赖的Derby库一起打包进去。NetBeans里运行正常是因为IDE会自动把所有依赖Jar加入到运行时的类路径里，但单独运行Jar文件时，JVM找不到Derby的驱动类，就抛出了ClassNotFoundException。

下面给你几个实用的解决方案，选一个适合你的就行：

方案1：用Maven Assembly Plugin打包包含所有依赖的可执行Jar #

这是最常用的方式，能直接生成一个包含所有依赖的独立Jar，双击或者命令行都能直接运行。

在你的pom.xml里添加以下插件配置：

<build>
    <plugins>
        <plugin>
            <groupId>org.apache.maven.plugins</groupId>
            <artifactId>maven-assembly-plugin</artifactId>
            <version>3.3.0</version>
            <configuration>
                <!-- 选择预定义的打包描述符，自动包含所有依赖 -->
                <descriptorRefs>
                    <descriptorRef>jar-with-dependencies</descriptorRef>
                </descriptorRefs>
                <!-- 一定要指定你的主类全路径，不然Jar无法直接运行 -->
                <archive>
                    <manifest>
                        <mainClass>com.yourpackage.YourMainClass</mainClass>
                    </manifest>
                </archive>
            </configuration>
            <executions>
                <execution>
                    <id>make-assembly</id>
                    <!-- 绑定到package阶段，执行mvn package时自动生成带依赖的Jar -->
                    <phase>package</phase>
                    <goals>
                        <goal>single</goal>
                    </goals>
                </execution>
            </executions>
        </plugin>
    </plugins>
</build>

配置好后，执行命令：

mvn clean package

打包完成后，去target目录找名字带-jar-with-dependencies后缀的Jar文件，运行这个Jar就没问题了。

方案2：用Maven Shade Plugin打包（功能更灵活） #

Shade插件也是Maven官方的打包工具，比Assembly更灵活，还能处理类冲突等问题，适合复杂项目。

在pom.xml中添加配置：

<build>
    <plugins>
        <plugin>
            <groupId>org.apache.maven.plugins</groupId>
            <artifactId>maven-shade-plugin</artifactId>
            <version>3.4.1</version>
            <executions>
                <execution>
                    <phase>package</phase>
                    <goals>
                        <goal>shade</goal>
                    </goals>
                    <configuration>
                        <transformers>
                            <!-- 指定主类，生成可执行Jar -->
                            <transformer implementation="org.apache.maven.plugins.shade.resource.ManifestResourceTransformer">
                                <mainClass>com.yourpackage.YourMainClass</mainClass>
                            </transformer>
                        </transformers>
                    </configuration>
                </execution>
            </executions>
        </plugin>
    </plugins>
</build>

同样执行mvn clean package，target目录下的主Jar就是包含所有依赖的可执行文件。

方案3：手动指定类路径运行（不修改打包配置） #

如果不想改pom.xml，也可以在运行Jar时手动把Derby的Jar加入类路径：

# Windows系统用分号分隔
java -cp "your-app.jar;path/to/derby-10.14.1.0.jar" com.yourpackage.YourMainClass

# Linux/Mac系统用冒号分隔
java -cp "your-app.jar:path/to/derby-10.14.1.0.jar" com.yourpackage.YourMainClass

不过这种方式每次运行都要写长命令，不如前两种方便。

额外小提示 #

从JDBC 4.0开始，JVM会自动扫描类路径下的META-INF/services/java.sql.Driver文件来加载驱动，所以你可以把代码里的Class.forName("org.apache.derby.jdbc.EmbeddedDriver").newInstance();这行删掉，简化代码，效果是一样的。

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