在Java开发中,将程序打包成可执行的JAR文件是一种常见的部署方式，通过命令行执行JAR包能够灵活地控制运行参数和环境，适用于服务器部署、自动化脚本等多种场景，以下是关于命令行执行JAR包的详细说明，包括基本语法、常用参数、高级配置及常见问题解决方法。
基本命令语法
执行JAR包的核心命令是java -jar，其基本语法为：
java [选项] -jar jar文件名 [参数]
选项是JVM虚拟机的运行参数（如内存设置、调试模式等），jar文件名为目标可执行JAR的完整路径，参数是传递给主程序的运行参数（如配置文件路径、功能开关等）。
java -jar myapp.jar --config=/path/to/config.xml --debug=true
JVM常用参数配置
在执行JAR包时,合理配置JVM参数对程序性能至关重要，以下为常用参数及作用说明：
| 参数类型 | 参数示例 | 作用说明 |
|---|---|---|
| 内存设置 | -Xms512m -Xmx1024m |
设置JVM初始堆内存（-Xms）和最大堆内存（-Xmx），需根据程序实际需求调整，避免内存溢出。 |
| 垃圾回收 | -XX:+UseG1GC |
指定垃圾回收器，G1GC适用于大内存应用，可减少停顿时间。 |
| 类路径 | -Djava.class.path=/lib/* |
手动添加依赖JAR包路径，若JAR包未包含所有依赖，需通过-cp或-classpath指定额外库。 |
| 日志配置 | -Dlogging.config=/logback.xml |
指定日志配置文件路径，覆盖JAR包内的默认配置。 |
| 调试模式 | -agentlib:jdwp=transport=dt_socket,server=y,suspend=n,address=5005 |
开启远程调试，允许IDE连接调试程序。 |
可执行JAR的MANIFEST.MF配置
若JAR包需直接通过java -jar执行，需在META-INF/MANIFEST.MF文件中指定主类入口。
Main-Class: com.example.MainApp
若依赖外部JAR包，可通过Class-Path字段添加相对路径（需确保路径正确）。
高级执行场景
-
后台运行与日志输出
使用nohup命令让程序在后台运行，并将日志输出到文件：
nohup java -jar myapp.jar > app.log 2>&1 &
其中2>&1表示将错误输出重定向到标准输出文件。
（图片来源网络，侵删） -
系统服务化（Linux）
通过systemd将JAR程序注册为系统服务，创建服务文件/etc/systemd/system/myapp.service：[Unit] Description=My Java Application After=network.target [Service] ExecStart=/usr/bin/java -jar /opt/myapp.jar User=javauser Restart=on-failure [Install] WantedBy=multi-user.target
启用服务：
systemctl enable --now myapp -
多环境配置
通过系统属性区分环境，例如生产环境加载不同配置：
java -Dspring.profiles.active=prod -jar myapp.jar
常见问题排查
-
“找不到主类”错误
原因：MANIFEST.MF中Main-Class配置错误或依赖缺失。
解决：检查jar tf myapp.jar确认主类路径，或通过java -cp myapp.jar com.example.MainApp手动指定类路径执行。
（图片来源网络，侵删） -
内存溢出（OOM）
原因：堆内存不足或内存泄漏。
解决：增加-Xmx值，或使用-XX:+HeapDumpOnOutOfMemoryError生成堆转储文件分析。 -
依赖冲突
原因：JAR包依赖版本不一致或类路径冲突。
解决：使用mvn dependency:tree（Maven）或gradle dependencies（Gradle）检查依赖树，通过-X参数查看类加载过程。
相关问答FAQs
Q1: 如何查看JAR包的依赖信息？
A1: 可使用以下方法：
- 命令行工具：
jar tf myapp.jar列出JAR包内容，查找META-INF/MANIFEST.MF中的Class-Path或直接查看lib/目录。 - 构建工具：Maven项目执行
mvn dependency:tree，Gradle项目执行gradle dependencies，生成完整的依赖树结构。 - 反编译工具：使用
jdeps（JDK自带）分析类依赖关系，jdeps -v myapp.jar。
Q2: 如何让JAR程序开机自启（Windows系统）？
A2: 在Windows中可通过以下方式实现：
- 任务计划程序：
- 打开“任务计划程序”，创建基本任务，触发器设为“计算机启动时”。
- 操作选择“启动程序”，填写
java.exe路径，参数栏输入-jar "C:\path\to\myapp.jar"。
- 将JAR注册为服务：
使用第三方工具如winsw，配置XML文件后通过install-service.bat安装为Windows服务，实现开机自启。
