Java / 系统课时

项目打包与运行

项目打包与运行

本课用一个最小 Maven 项目走完“配置 → 打包 → 用 java -jar 运行 → 核对产物”的全过程,并学会处理入口类缺失、类找不到和 Java 版本不匹配这三类最常见的启动报错。

学习目标

  • 用 pom.xml 声明项目坐标、编译版本和可执行 Jar 的入口类
  • 通过 mvn clean package 生成 Jar,并用 java -jar 运行和核对产物
  • 根据报错信息定位入口类、依赖和 Java 版本问题

检查构建环境

打包前先确认 Maven 和 JDK 都可用,并且 Maven 实际调用的 JDK 版本不低于项目的编译目标。本课按 Java 17 编译,用到的插件版本要求 Maven 3.6.3 及以上。

bash
mvn -v

预期结果(节选,实际版本号和路径因环境而异):

text
Apache Maven <VERSION>
Java version: <VERSION>, vendor: <VENDOR>, runtime: <PATH>

重点看第二行。Java version 是 Maven 编译时实际使用的 JDK:Maven 优先使用 JAVA_HOME 指向的 JDK,而 java -version 显示的是 PATH 里的那个,两者可能不同。

配置项目坐标与入口类

最小项目只需要两个文件:项目根目录下的 pom.xml,以及 src/main/java/com/example/Main.java。源码放在 src/main/java 下、目录层级与包名对应,这是 Maven 的约定布局,不需要额外配置。

pom.xml 中的 groupId、artifactId、version 三项坐标唯一标识这个构件,打包产物默认命名为 artifactId-version.jar,本例就是 demo-app-1.0.0.jar。

xml
<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0"
         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 https://maven.apache.org/xsd/maven-4.0.0.xsd">
    <modelVersion>4.0.0</modelVersion>

    <groupId>com.example</groupId>
    <artifactId>demo-app</artifactId>
    <version>1.0.0</version>
    <packaging>jar</packaging>

    <properties>
        <!-- 固定源码编码,避免中文在不同系统上编译出乱码 -->
        <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
        <!-- 按 Java 17 的 API 和字节码版本编译,运行环境必须是 17 或更高 -->
        <maven.compiler.release>17</maven.compiler.release>
    </properties>

    <build>
        <plugins>
            <!-- 显式指定版本:较老 Maven 自带的编译插件不认识 release 配置 -->
            <plugin>
                <groupId>org.apache.maven.plugins</groupId>
                <artifactId>maven-compiler-plugin</artifactId>
                <version>3.13.0</version>
            </plugin>
            <plugin>
                <groupId>org.apache.maven.plugins</groupId>
                <artifactId>maven-jar-plugin</artifactId>
                <version>3.4.2</version>
                <configuration>
                    <archive>
                        <manifest>
                            <!-- 写入 MANIFEST.MF 的 Main-Class,必须是带包名的全限定类名 -->
                            <mainClass>com.example.Main</mainClass>
                        </manifest>
                    </archive>
                </configuration>
            </plugin>
        </plugins>
    </build>
</project>

入口类的包声明必须与 mainClass 完全一致。这里声明了 package com.example;,所以清单里写 com.example.Main;漏写包声明或包名对不上,Jar 能打出来,运行时却找不到主类。

java
package com.example;

public class Main {
    public static void main(String[] args) {
        // 不传参数时使用默认值,方便先验证 Jar 能否正常启动
        String name = args.length > 0 ? args[0] : "Java";
        System.out.println("Hello, " + name + "!");
        // 打印实际运行的 Java 主版本,用来核对运行环境不低于编译目标
        System.out.println("Runtime: Java " + Runtime.version().feature());
    }
}

打包并运行 Jar

在 pom.xml 所在目录执行下面两条命令。clean 先删除旧的 target 目录,package 会依次完成编译、运行测试和打包,任何一步失败都不会生成新的 Jar。

bash
mvn clean package
java -jar target/demo-app-1.0.0.jar Anystack

预期结果:mvn clean package 的末尾出现下面两行,<PATH> 是生成的 Jar 的绝对路径,以 demo-app-1.0.0.jar 结尾;java -jar 随后输出程序结果,<VERSION> 是实际运行的 JDK 主版本,例如 17 或 21。

text
[INFO] Building jar: <PATH>
[INFO] BUILD SUCCESS
text
Hello, Anystack!
Runtime: Java <VERSION>

如果去掉命令末尾的 Anystack,第一行会变成 Hello, Java!。java -jar 之后的参数原样传给 main 方法的 args。

还可以用 JDK 自带的 jar 工具查看产物里到底有什么,确认类文件放在正确的包路径下、清单文件存在。

bash
jar tf target/demo-app-1.0.0.jar

预期结果(节选,条目顺序可能不同):

text
META-INF/MANIFEST.MF
com/example/Main.class
META-INF/maven/com.example/demo-app/pom.xml

启动报错的定位顺序

java -jar 启动失败时,先读报错的第一行,再按下表对应检查。中文环境下的 JDK 会显示括号里的中文提示。

报错 原因 处理
no main manifest attribute(没有主清单属性) 清单里没有 Main-Class 补上 maven-jar-plugin 的 mainClass 后重新打包
Could not find or load main class com.example.Main(找不到或无法加载主类) mainClass 与类的包名、类名不一致 对照 jar tf 的输出修正 mainClass 或包声明
UnsupportedClassVersionError,提示 class file version 61.0 按 Java 17 编译,却在更低版本上运行 升级运行环境,或把 maven.compiler.release 降到运行环境的版本
NoClassDefFoundError 指向第三方库的类 普通 Jar 不包含依赖 用 maven-shade-plugin 打成包含依赖的 Jar,或在清单中配置 Class-Path

target 目录每次构建都会重新生成,修复问题时改 pom.xml 或源码,不要直接改 target 里的文件。提交代码前执行一次 mvn clean verify:它在 package 之后还会执行项目里配置的集成测试和检查插件,问题能在合并前暴露。

练习

  1. 把 Main 改成命令行求和程序:传入两个整数时输出它们的和,参数个数不对或不是数字时输出用法说明并以非零状态码退出。重新打包后分别用合法和非法参数运行 java -jar 验证。
  2. 故意把 mainClass 改成 Main(去掉包名),重新打包运行,记录报错;再用 jar tf 的输出找出正确的全限定类名并修复。
按自己的节奏,确认真正理解。

目录与阅读设置

记录一个想法

项目打包与运行

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通