Maven项目Eclipse运行正常,打包可执行jar后报com.mysql.jdbc.Driver类找不到错误
报错核心原因
- Eclipse下运行正常的逻辑:Eclipse启动项目时会自动把项目关联的所有Maven依赖(包含runtime范围的依赖)全部加入JVM运行类路径,类加载器可以直接从本地仓库的
mysql-connector-java-5.1.49.jar中定位到com.mysql.jdbc.Driver类,因此能正常运行无报错。 - 打包后运行报错的触发点:Maven默认的打包逻辑(基于
maven-jar-plugin)生成的是瘦Jar,这个包只包含项目自身编写的代码、资源文件,完全不会嵌入任何外部依赖——哪怕你已经在pom中声明了MySQL驱动。而执行java -jar命令时,JVM的类加载范围仅限当前Jar包内部,不会自动关联本地Maven仓库的依赖文件,自然会抛出ClassNotFoundException。 - 关于依赖scope的说明:你给MySQL驱动配置的
<scope>runtime</scope>本身没有语法错误,这个配置的含义是“该依赖仅在项目运行、测试阶段需要加载,编译期不参与编译校验”,但它本身不会触发Maven把该依赖整合到最终Jar包的流程。
补充排查点:如果之前手动配置过
maven-jar-plugin,需要检查插件配置中生成的Class-Path清单项,有没有遗漏mysql-connector-java的Jar地址,这种情况也会触发类找不到的报错。
对应解决方法
- 方法1:配置
maven-shade-plugin插件,将所有外部依赖一并打入最终Jar包,生成胖Jar。插件会自动在Jar的元数据目录配置正确的类路径,打包完成后直接用java -jar就能正常加载MySQL驱动。
配置需要加到pom.xml的<build><plugins>节点下,示例:<plugin> <groupId>org.apache.maven.plugins</groupId> <artifactId>maven-shade-plugin</artifactId> <version>3.5.1</version> <executions> <execution> <phase>package</phase> <goals> <goal>shade</goal> </goals> </execution> </executions> </plugin> - 方法2:如果项目是Spring Boot构建的,直接用框架自带的
spring-boot-maven-plugin打包即可,该插件默认就会把所有运行期依赖嵌入Jar包,不需要额外手动配置。 - 方法3:不修改打包逻辑,运行时手动把依赖追加到类路径。这种方式不需要调整pom配置,但每次运行都需要手动指定依赖位置,维护成本较高,示例命令:
# Linux/macOS 系统 java -cp ./target/project.jar:~/.m2/repository/mysql/mysql-connector-java/5.1.49/mysql-connector-java-5.1.49.jar 你的主类全限定名 # Windows 系统 java -cp ./target/project.jar;C:\Users\你的用户名\.m2\repository\mysql\mysql-connector-java\5.1.49\mysql-connector-java-5.1.49.jar 你的主类全限定名
内容的提问来源于stack exchange,提问作者NITESH KUMAR
相关产品推荐
相关产品推荐

