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 及以上。
mvn -v预期结果(节选,实际版本号和路径因环境而异):
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 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 能打出来,运行时却找不到主类。
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。
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。
[INFO] Building jar: <PATH>
[INFO] BUILD SUCCESSHello, Anystack!
Runtime: Java <VERSION>如果去掉命令末尾的 Anystack,第一行会变成 Hello, Java!。java -jar 之后的参数原样传给 main 方法的 args。
还可以用 JDK 自带的 jar 工具查看产物里到底有什么,确认类文件放在正确的包路径下、清单文件存在。
jar tf target/demo-app-1.0.0.jar预期结果(节选,条目顺序可能不同):
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 之后还会执行项目里配置的集成测试和检查插件,问题能在合并前暴露。
练习
- 把
Main改成命令行求和程序:传入两个整数时输出它们的和,参数个数不对或不是数字时输出用法说明并以非零状态码退出。重新打包后分别用合法和非法参数运行java -jar验证。 - 故意把
mainClass改成Main(去掉包名),重新打包运行,记录报错;再用jar tf的输出找出正确的全限定类名并修复。