Maven 项目打包及启动时的报错解决

Posted 知音12138

tags:

篇首语:本文由小常识网(cha138.com)小编为大家整理,主要介绍了Maven 项目打包及启动时的报错解决相关的知识,希望对你有一定的参考价值。

一、报错:xxx.jar中没有主清单属性

方式一、手动修改MANIFEST.MF 文件配置

  1. 通过 7z 等压缩工具打开 jar 包

  2. 修改 META-INF 目录中的 MANIFEST.MF 文件(选中文件后右键选择编辑而不是打开)

  3. 在原有内容的末尾加上一行:

    上图为已经操作过的结果

    Main-Class: com.zhiyin.screenshot.ScreenShotDemo(全限定名,不加后缀)
    
    • 键值之间必须用英文冒号隔开,并且必须后接一个(仅有一个)空格

    • 修改文件后记得保存,同时压缩工具会提醒是否更新压缩文件,选择(选择否时修改不生效,该报错还报错)

方式二、使用插件并配置主函数

  1. pom.xml 配置文件中加入以下配置(注意标签的嵌套)

    参考后续 pom.xml 配置文件中的主函数配置

  2. 待下载完成插件后,在项目的 Maven 窗口的 Plugins 下即可找到 assembly 插件(如果没有请刷新)

  3. 使用 assembly:assembly 完成项目的打包

二、报错:Invalid or corrupt jarfile xxx.jar

分析

使用步骤 1 中修改 MANIFEST.MF 文件的方式来设置主函数时是否配置正确,键和值之间是否有英文冒号加空格,且英文和符号必须全为半角状态

三、报错:java.lang.NoClassDefFoundError

分析

因为是通过 IDEA 中 Maven 项目的 Lifecycle 中的 package 操作完成打包的,所以该命令默认是不会把依赖的 jar 包构建到 target 中,导致程序启动时找不到类报错

解决

借助于 Maven 插件完成

  1. pom.xml 文件中加入配置

    注意标签的嵌套

    <project>
        <build>
            <plugins>
                <plugin>
                    <artifactId>maven-assembly-plugin</artifactId>
                    <configuration>
                        <archive>
                            <manifest>
                                <!-- 配置jar包主函数 -->
                                <mainClass>com.zhiyin.screenshot.ScreenShotDemo</mainClass>
                            </manifest>
                        </archive>
                        <!-- 生成的包含依赖jar的jar包名称 -->
                        <descriptorRefs>
                            <descriptorRef>jar-with-dependencies</descriptorRef>
                        </descriptorRefs>
                    </configuration>
                </plugin>
            </plugins>
        </build>
    </project>
    
  2. 加入配置后,等待插件完成下载后,在项目的 Maven 窗口 Plugs 下就会出现

  3. 通过 assembly 插件进行打包的操作后,再进入到 target 目录中,会发现多出一个 descriptorRef 标签中的指定名称的 jar 包,打开 jar 包时会发现依赖的 jar 的也在其中

四、知识点

  • 全限定名:包名 + 类名(不包括类的后缀名),包与包之间,包与类之间的层级关系用 . 表示,包的最顶层为程序中的源代码目录,Maven 项目中则为 Sources Root 下的包

  • 使用 assembly 插件进行打包操作时,会在 target 目录中生成两个 jar 包,一个为默认的 jar 包,一个为包含了程序依赖 jar 包的 jar 包

以上是关于Maven 项目打包及启动时的报错解决的主要内容,如果未能解决你的问题,请参考以下文章

Docker启动时的报错汇总

maven创建web项目的报错解决方案

Maven打包报错解决方案Using ‘UTF-8‘ encoding to copy filtered resources.

Maven打包报错解决方案Using ‘UTF-8‘ encoding to copy filtered resources.

解决maven的报错

项目中的报错信息,maven报错等的总结