Java启动参数解密：-D与--的奥秘与实战应用

在Java应用部署和运维过程中，正确理解和使用启动参数至关重要。
无论是Spring Boot应用还是传统Java程序，启动参数都直接影响
应用的行为和配置。本文深入解析-D与--参数的区别与联系，
助你精准控制Java应用的启动行为。

一、启动参数概述

（一）Java启动命令基本结构

Java应用启动命令通常遵循以下基本结构：

java [JVM参数] -jar application.jar [应用程序参数]

其中：

• JVM参数：以-D或-X等开头，用于配置JVM行为
• 应用程序参数：以--开头或直接跟在jar包后，用于配置应用行为

（二）常见启动命令示例

# 基本启动命令
java -jar myapp.jar

# 带JVM系统属性的启动命令
java -Dfile.encoding=UTF-8 -jar myapp.jar

# 带应用参数的启动命令
java -jar myapp.jar --server.port=8080

# 同时使用JVM参数和应用参数
java -Dfile.encoding=UTF-8 -jar myapp.jar --server.port=8080

二、-D参数详解

（一）-D参数的作用

-D参数用于设置JVM系统属性(System Properties)，
这些属性在整个JVM生命周期内都可访问。

# 设置系统属性示例
java -Dfile.encoding=UTF-8 -Duser.timezone=GMT+8 -jar myapp.jar

（二）-D参数的特点

1. 必须放在-jar参数之前
2. 设置的是JVM级别的系统属性
3. 可通过System.getProperty()方法获取

// 在Java代码中获取-D参数设置的值
String encoding = System.getProperty("file.encoding");
String timezone = System.getProperty("user.timezone");

（三）-D参数的应用场景

1. 设置JVM编码格式
2. 指定配置文件路径
3. 配置日志级别
4. 设置JVM内存参数（部分情况）

# 实际应用示例
java -Dfile.encoding=UTF-8 \
     -Dlog.level=DEBUG \
     -Dconfig.path=/etc/myapp/config.properties \
     -jar myapp.jar

三、--参数详解

（一）--参数的作用

--参数主要用于应用程序级别的配置，
特别是在Spring Boot应用中广泛使用。

# Spring Boot应用参数示例
java -jar myapp.jar --server.port=8080 --spring.profiles.active=prod

（二）--参数的特点

1. 必须放在-jar参数和jar包之后
2. 主要用于应用配置
3. 在Spring Boot中可直接覆盖application.properties配置

// 在Spring Boot中通过@Value注解获取--参数
@Value("${server.port:8080}")
private int serverPort;

（三）--参数的应用场景

1. 覆盖配置文件中的属性
2. 指定运行环境
3. 设置应用特定参数

# Spring Boot实际应用示例
java -jar myapp.jar \
     --server.port=9090 \
     --spring.profiles.active=prod \
     --logging.level.root=INFO

四、其他参数传递方式

（一）直接参数传递

直接将参数跟在jar包后面，作为main方法的args参数传递。

# 直接参数传递示例
java -jar myapp.jar arg1 arg2 arg3

// 在main方法中获取参数
public static void main(String[] args) {
    // args数组包含传递的参数: ["arg1", "arg2", "arg3"]
    for (int i = 0; i < args.length; i++) {
        System.out.println("参数" + i + ": " + args[i]);
    }
}

（二）环境变量

通过设置环境变量来传递配置信息。

# Linux/Unix环境设置环境变量
export SERVER_PORT=8080
java -jar myapp.jar

（三）配置文件

通过外部配置文件来设置应用参数。

# 指定配置文件位置
java -Dspring.config.location=/path/to/config/application.properties -jar myapp.jar

五、参数传递方式对比

（一）各种参数方式的特点对比

参数类型	使用位置	获取方式	作用范围	主要用途
-D参数	-jar之前	System.getProperty()	JVM级别	JVM配置、系统属性
--参数	-jar之后	@Value注解或配置类	应用级别	应用配置、Spring Boot属性
直接参数	-jar之后	main方法args参数	应用级别	程序参数、命令行输入
环境变量	系统环境	System.getenv()	系统级别	系统环境、容器配置

（二）实际应用示例对比

# 使用不同方式传递相同配置项的示例
# 1. 通过-D参数设置
java -Dserver.port=8080 -jar myapp.jar

# 2. 通过--参数设置
java -jar myapp.jar --server.port=8080

# 3. 通过直接参数传递
java -jar myapp.jar 8080

# 4. 通过环境变量设置
export SERVER_PORT=8080
java -jar myapp.jar

六、参数优先级与覆盖规则

（一）Spring Boot中的参数优先级

在Spring Boot应用中，不同参数源具有不同的优先级：

1. 命令行参数(--参数) - 最高优先级
2. 系统属性(-D参数) - 高优先级
3. 操作系统环境变量 - 中等优先级
4. application-{profile}.properties - 低优先级
5. application.properties - 最低优先级

（二）参数覆盖示例

# application.properties中配置
server.port=8080

# 系统属性覆盖
java -Dserver.port=9090 -jar myapp.jar

# 命令行参数覆盖（最终生效）
java -Dserver.port=9090 -jar myapp.jar --server.port=7070

在上述示例中，最终生效的端口是7070，因为命令行参数具有最高优先级。

七、实际应用场景

（一）开发环境调试

# 开发环境启动，开启调试模式
java -Ddebug=true -Dlog.level=DEBUG -jar myapp.jar --spring.profiles.active=dev

（二）生产环境部署

# 生产环境启动，指定配置文件和端口
java -Dspring.config.location=file:/etc/myapp/ \
     -Dfile.encoding=UTF-8 \
     -jar myapp.jar \
     --server.port=80 \
     --spring.profiles.active=prod

（三）容器化部署

# Docker容器中启动应用
java -Djava.security.egd=file:/dev/./urandom \
     -Duser.timezone=Asia/Shanghai \
     -jar myapp.jar \
     --server.port=8080

八、最佳实践建议

（一）参数使用原则

1. JVM相关配置使用-D参数
2. 应用配置优先使用--参数
3. 敏感信息通过环境变量传递
4. 合理利用参数优先级机制

（二）安全建议

1. 避免在命令行中传递敏感信息（如密码）
2. 敏感配置应通过环境变量或配置文件传递
3. 生产环境中谨慎使用调试参数

（三）可维护性建议

1. 统一团队参数使用规范
2. 为常用参数建立文档说明
3. 合理组织复杂应用的参数配置

九、总结

Java启动参数是控制应用行为的重要手段，理解-D与--参数的区别对于
正确配置和部署Java应用至关重要。-D参数主要用于设置JVM系统属性，
而--参数主要用于应用级别的配置，特别是在Spring Boot应用中广泛使用。
通过合理使用这些参数，可以实现灵活的应用配置和环境适配。

参考文档

1. Oracle Java命令行文档
2. Spring Boot外部化配置官方文档
3. Java系统属性详解
4. Spring Boot配置优先级说明