Java jar 启动程序参数说明

Springboot环境下的启动参数说明

# Java启动命令语法：
java [options] -jar file.jar [arguments]
java -jar [options] file.jar [arguments]
javaw [options] -jar file.jar [arguments] #javaw不会启动一个控制台窗口(启动失败的时候会弹出附有错误信息的窗口)
# 可选项(options)
# 程序参数(arguments)
# -jar 指定以 jar 包的形式执行一个应用程序

# 1、标准可选项(Standard options)
java -Dserver.port=8081 -jar app.jar     #（系统参数）-Dxxx是java运行参数的语法，作用是配置一些环境变量

# -D 是java用来设置全局参数的，可覆盖yaml文件中的变量，但无法覆盖远程Nacos变量值
# --key=value 可覆盖Nacos，优先级最高

-Dspring.profiles.active
-Dspring.config.location                 # 指定打包后配置文件的路径
-Dfile.encoding=utf=8                    # 设置字符集
-Djava.security.egd=file:/dev/./urandom  # 可以一定程度上加快应用启动
-Dspring.config.additional-location=./application-dev.yml      # 加载服务器配置文件

# 2、非标准可选项(Nonstandard Options)
java -Xms512m -Xmx1024m -jar app.jar

-Xms512m     　　　　　　　　# JVM初始堆内存
-Xmx1024m   　　　　　　　　 # JVM最大堆内存
-XX:PermSize=256m　　　　   # JVM初始非堆内存
-XX:MaxPermSize=512m　　    # JVM最大非堆内存

# 3、程序参数(arguments)
java -jar app.jar a b c                # （非选项参数）a,b,c参数就是jar包里主启动类中main方法的args参数，按顺序来
java -jar app.jar --server.port=8081   # （选项参数）其作用等价于在application.properties中的server.port=8081

--server.port=8081
--spring.profiles.active=dev
--spring.cloud.bootstrap.name=bootstrap-dev
--spring.cloud.nacos.config.server-addr=127.0.0.3:8848

查看更多启动命令
查看三种参数形式(系统参数/选项参数/非选项参数)

后台运行jar包且指定输出文件

# nohup 不挂断地运行命令；& 在后台运行，一般两个一起用：nohup command &
nohup java -jar app.jar >outlog.log 2>&1 &

# >outlog.log 2>&1 这条命令其实分为两命令，一个是>outlog.log，另一个是2>&1
# >outlog.log 将标准输出1重定向到outlog.log中
# 2>&1 这条命令用到了重定向绑定，采用&将错误输出绑定到标准输出上，作用是错误输出将和标准输出同用一个文件描述符

程序参数(选项/非选项参数)

可以通过ApplicationArguments接口获取，选项参数也可以通过@Value在类中获取。

具体获取方法直接在使用参数的类中注入该接口即可

@RestController
public class ArgumentsController {
  @Resource
  private ApplicationArguments arguments;

  @GetMapping("/args")
  public void getArgs() {
      System.out.println("# 非选项参数数量: " + arguments.getNonOptionArgs().size());
      System.out.println("# 选项参数数量: " + arguments.getOptionNames().size());
      System.out.println("# 非选项具体参数:");
      arguments.getNonOptionArgs().forEach(System.out::println);

      System.out.println("# 选项参数具体参数:");
      arguments.getOptionNames().forEach(optionName -> {
          System.out.println("--" + optionName + "=" + arguments.getOptionValues(optionName));
      });
  }
}

可选项(系统参数)

(-Dproperty=value)可以通过@Value或java.lang.System提供的方法获取

@RestController
public class ParamController {

  @Value("${property}")
  private String serverPort;

  public void test(){
     String systemServerPort = System.getProperty("property"); // -Dproperty
  }
}

配置文件的优先级

# 启动服务后，各个配置文件的加载顺序为:
先加载本地符合的配置文件(bootstrap.yml的读取优先级最高)，再加载nacos上面的配置文件

(本地)bootstrap.yml > (本地)application.yml > (本地)application-dev.yml > (nacos)order-service.yaml >
(nacos)order-service-dev.yaml

重点：后加载的配置会覆盖前面加载的配置内容

注意：bootstrap.yml配置的属性值不会被覆盖，即优先级最高

# Springboot加载参数的优先级:（优先级高的会覆盖优先级低的配置）
[程序参数]Program arguments (--priority=program-agrs) >
[JVM系统变量]VM options (-Dpriority=vm-options) >
[环境变量]Environment variable (priority=environment-variables) >
[配置文件变量]

# 这里不是指加载顺序，就是优先级
即：如果VM options 有一个变量和 Environment variable中的变量的key相同，则以VM options 中为准。
即：程序参数会覆盖Yaml配置文件的变量

无法覆盖远程配置中心(Nacos)问题

方式一：通过启动时配置程序参数：--priority=program-agrs

方式二：通过选项参数传入变量值：-DPORT=50101
server:
  port: ${PORT:50101}

方式三：修改nacos配置序号，使之采用addLast加载而非addFirst，从而实现命令行参数优先级大于远程配置中心。
PS：该方案直接修改了nacos中所有配置优先级，使之从first变为last，可能存在风险，请慎用！
在远程Nacos配置中心添加：（本地配置覆盖远程 本地配置优先）
spring:
  cloud:
    config:
      override-none: true
      allow-override: true
      override-system-properties: false

使用idea设置参数

1. VM options 需要以 -D 或 -X 或 -XX 开头，每个参数最好使用空格隔开。

2. Program arguments 每个参数需要以空格隔开。否则将会被识别成一个参数，自己用的时候还得手动处理。

3. Environment variable 没有前缀，优先级低于 VM options ，即如果VM options 有一个变量和 Environment variable中的变量的key相同，则以VM options 中为准，（如果用命令行启动，这个参数需要在运行java类以前使用 set JAVA_HOME=D:\jdk1.8.0_05 这种方式进行临时修改，这种方式只在当前cmd窗口有效，点击看详情 设置临时的java环境变量）。

获取系统参数的方法

java提供了System类的静态方法getenv()和getProperty()用于返回系统相关的变量与属性。

• getProperty() 方法返回的变量大多与java程序有关。

• System.getenv() 方法是获取指定的环境变量的值。

• System.getenv(String name) 接收参数为任意字符串，当存在指定环境变量时即返回环境变量的值，否则返回null。

• System.getProperty() 是获取系统的相关属性，包括文件编码、操作系统名称、区域、用户名等，此属性一般由jvm自动获取，不能设置。

• System.getProperty(String key) 接收参数为任意字符串，当存在指定属性时即返回属性的值，否则返回null。