You need to enable JavaScript to run this app. Maven项目Eclipse运行正常,打包可执行jar后报com.mysql.jdbc.Driver类找不到错误
优惠活动
大模型
产品
解决方案
定价
更多

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

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.11.04 12:45:02