Java 命令行参数详解：系统属性、JVM 选项与应用配置

在 Java 应用启动命令中，如：

java -jar -Dserver.port=8088 xdr-demo-1.0-SNAPSHOT-assembly.jar &

-Dserver.port=8088是一个 系统属性（System Property） 设置。类似的参数都属于 Java 命令行选项，主要分为以下几类：

一、核心参数类型

标准选项 (-)
- 格式： -选项名[=值]
- 作用： 所有符合规范的 JVM 实现都必须支持的选项。
- 关键示例：
  - -D<name>=<value> (系统属性): 最常用、最灵活的应用配置方式。
    - -Dserver.port=8088 (设置应用端口)
    - -Dspring.profiles.active=prod (设置 Spring Boot 环境)
    - -Dlog4j.configurationFile=/path/to/log4j2.xml (设置 Log4j2 配置文件)
    - -Djava.net.preferIPv4Stack=true (优先使用 IPv4)
    - -Duser.timezone=GMT+08:00 (设置 JVM 默认时区)
  - -classpath 或 -cp: 设置类路径。
    - -cp lib/*:conf/ com.example.Main
  - -jar <filename>: 执行可运行的 JAR 文件。
  - -version: 显示版本信息。
  - -showversion: 显示版本信息并继续执行。
  - -? / -help: 显示标准选项帮助。
非标准选项 (-X)
- 格式： -X选项名[=值]
- 作用： 特定于 HotSpot JVM 的通用选项（其他 JVM 实现可能不支持或含义不同）。
- 关键示例：
  - -Xms<size>: 设置初始堆大小。
    - -Xms512m (初始堆 512MB)
  - -Xmx<size>: 设置最大堆大小。
    - -Xmx2048m (最大堆 2048MB/2GB)
  - -Xss<size>: 设置 线程栈 大小。
    - -Xss256k (每个线程栈 256KB)
  - -Xmn<size>: 设置 年轻代 (Young Generation) 大小（通常建议让 JVM 自动调整）。
  - -XshowSettings: 显示所有设置（系统属性、区域设置等）。
  - -Xloggc:<file>: 将 GC 日志输出到文件。
    - -Xloggc:/logs/gc.log
  - -X: 显示非标准选项 (-X) 的帮助信息。
高级运行时选项 (-XX:)
- 格式： -XX:+<option> (启用), -XX:-<option> (禁用), -XX:<option>=<value> (设置值)
- 作用： 用于 JVM 调优、诊断、低级别控制的“旋钮”。这些选项不稳定（不同 JVM 版本可能变更或移除），需谨慎使用。
- 关键示例：
  - 内存与 GC 调优：
    - -XX:+UseG1GC (启用 G1 垃圾收集器)
    - -XX:MaxGCPauseMillis=200 (设置 GC 最大停顿时间目标)
    - -XX:NewRatio=2 (老年代:年轻代 = 2:1)
    - -XX:SurvivorRatio=8 (Eden:Survivor = 8:1)
    - -XX:MetaspaceSize=256m (元空间初始大小)
    - -XX:MaxMetaspaceSize=512m (元空间最大大小)
    - -XX:+HeapDumpOnOutOfMemoryError (OOM 时生成堆转储)
    - -XX:HeapDumpPath=/path/to/dumps (指定堆转储路径)
  - 调试/诊断：
    - -XX:+PrintGCDetails (打印详细 GC 日志)
    - -XX:+PrintGCDateStamps (在 GC 日志中添加时间戳)
    - -XX:+PrintCommandLineFlags (打印 JVM 启动时使用的 -XX 标志)
    - -XX:NativeMemoryTracking=summary/detail (启用 NMT 跟踪本地内存)
  - 其他：
    - -XX:MaxDirectMemorySize=1g (设置直接内存最大容量)
    - -XX:+DisableExplicitGC (禁止显式调用 System.gc())
程序参数
- 位置： 在 -jar <jarfile> 或主类名之后的所有参数。
- 作用： 传递给 Java 应用程序的 main(String[] args) 方法的参数。
- 示例： java -jar myapp.jar arg1 arg2 arg3，在 main 方法中 args[0]="arg1", args[1]="arg2"。

二、深入理解 `-D`：系统属性的强大应用

-D 是配置 Java 应用最常用、最核心的机制。其核心原理与用途如下：

核心原理：
- 在 JVM 启动时，将指定的键值对 (<name>=<value>) 加载到 JVM 内部的全局 Properties 集合中。
- 应用程序在运行时可以通过 System.getProperty(String name) 或 System.getProperty(String name, String default) 方法读取这些值。
- 许多流行的框架和库（如 Spring Boot, Tomcat, Logback, Log4j）都深度依赖系统属性进行配置。
常见应用场景：
- 配置服务器端口： -Dserver.port=8088
- 激活配置文件： -Dspring.profiles.active=production
- 指定日志配置文件：
  - Logback: -Dlogback.configurationFile=/path/to/logback.xml
  - Log4j2: -Dlog4j.configurationFile=/path/to/log4j2.xml
- 设置文件编码： -Dfile.encoding=UTF-8
- 设置时区： -Duser.timezone=Asia/Shanghai
- 覆盖配置文件中的属性： -Dmyapp.config.db.url=jdbc:mysql://newhost:3306/db
- 开启调试/诊断模式： -Dmyapp.debug=true
- 设置网络偏好： -Djava.net.preferIPv4Stack=true
- 配置临时目录： -Djava.io.tmpdir=/mytemp

如何在代码中使用：

public class MyApp {public static void main(String[] args) {// 读取 server.port 属性，如果未设置则使用默认值 8080String port = System.getProperty("server.port", "8080");int portNumber = Integer.parseInt(port);// 读取环境激活配置String activeProfile = System.getProperty("spring.profiles.active", "default");System.out.println("Server will start on port: " + portNumber);System.out.println("Active profile: " + activeProfile);// ... 应用启动逻辑}
}

三、关键使用说明与最佳实践

参数顺序至关重要：
- -D、-X、-XX 等 JVM 选项 必须放在 java 命令之后，但在 -jar <jarfile> 或主类名之前。
- 程序参数 必须放在 -jar <jarfile> 或主类名之后。
- 错误示例： java -jar myapp.jar -Dport=8080 (这里的 -Dport=8080 会被传递给 main 方法的 args，而不是作为系统属性设置！)
值中的空格与特殊字符：
- 如果属性值包含空格，必须用引号括起来。
- 示例： java -Dmessage="Hello World" -jar myapp.jar
查看可用选项：
- java -? / java -help：显示标准选项。
- java -X：显示非标准选项 (-X 选项) 的帮助。
- java -XX:+PrintFlagsFinal：显示所有 -XX 选项及其当前值（输出非常庞大，通常结合 grep 使用）。
选择正确的参数类型：
- 应用配置 (端口、环境、文件路径、业务参数)： 优先使用 -D (系统属性)。这是最通用、最符合应用逻辑的方式。
- JVM 资源管理 (堆大小、栈大小)： 使用 -Xms, -Xmx, -Xss。
- JVM 高级调优与诊断 (GC 选择、日志、内存跟踪)： 使用 -XX: 选项。使用前务必查阅对应 JVM 版本的文档。

环境变量替代：

系统属性 (-D) 也可以通过环境变量设置，但 Java 代码读取方式不同 (System.getenv() vs System.getProperty())。框架通常优先支持系统属性。

Shell 脚本示例 (动态设置):

#!/bin/bash
APP_PORT=${APP_PORT:-8080} # 默认值 8080
ACTIVE_PROFILE=${ACTIVE_PROFILE:-dev} # 默认值 devjava -Dserver.port=$APP_PORT \-Dspring.profiles.active=$ACTIVE_PROFILE \-Xms256m -Xmx1024m \-jar /path/to/xdr-demo-1.0-SNAPSHOT-assembly.jar &