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    # 覆盖原有内容
>>outlog.log   # 将输出结果追加到文件末尾

# 在Linux系统中0 1 2是一个文件描述符：
标准输入(stdin)  0  # 0表示键盘输入
标准输出(stdout) 1  # 1表示屏幕输出
错误输出(stderr) 2  # 2表示错误输出

2>&1的含义：

将标准错误输出重定向到标准输出。

注意：符号>&是一个整体，不可分开，分开后就不是上述含义了。

cat test 2>&1 >file

错误输出到终端，标准输出被重定向到文件file。

cat test >file 2>&1

标准输出被重定向到文件file，然后错误输出也重定向到和标准输出一样，所以也错误输出到文件file。

command >out.file 2>&1 &

• command > out.file 是将command的输出重定向到out.file文件，输出内容不打印到屏幕上，而是输出到out.file文件中。
• 2>&1 是将标准出错重定向到标准输出，因为标准输出已经重定向到了out.file文件，所以标准出错也输出到out.file文件中。
• 最后一个&， 是让该命令在后台执行。

通俗的说，就是把所有标准输出和标准出错都输出到out.file文件。

command >/dev/null 2>&1 &

/dev/null：Linux的空设备，所有写入它的数据都会被丢弃。

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

可以通过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和application.yml中存在同名配置项，那么在大多数情况下，application.yml中的配置会覆盖bootstrap.yml中的配置。这是因为application.yml的加载顺序通常晚于bootstrap.yml，意味着它的配置项会覆盖或修改先前加载的配置。
但是，有些配置项可能被标记为只应从bootstrap.yml中读取，这意味着它们不能被子类覆盖。这些配置项通常用于设置一些在应用启动时必须设置的属性，例如nacos配置信息、数据库连接详细信息。

# 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配置文件的变量

当外部定义了/config/bootstrap.yml

在部署Java项目时，指定外部的/config/bootstrap.yml 文件，那么这个外部文件中的配置会优先于内置的 resources/bootstrap.yml文件中的配置被加载和应用。也就是说，如果两者中有任何冲突的配置，外部文件中的配置将会覆盖内置文件中的配置。

Springboot 启动会扫描以下位置的application.properties或者application.yml文件作为Spring boot的默认配置文件。

java -jar myproject.jar --spring.config.location=classpath:/default.yml,classpath:/override.yml

–file:./config/
–file:./
–classpath:/config/
–classpath:/

优先级由高到低，高优先级的配置会覆盖低优先级的配置。

如果想指定自定义目录的配置文件，则可以使用以下方式：

java -jar myproject.jar --spring.config.location=d://data/application.yml
java -jar myproject.jar --spring.config.location=http://example.com/config.yml

# Spring Boot会按照指定的顺序加载配置文件。因此，在覆盖配置时，请确保覆盖的配置文件在指定的位置之后加载。

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

经测试，通过配置启动参数：-Dserver.port=8081 或 --server.port=8081 均无法覆盖nacos属性

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

方式二：在远程Nacos配置中心添加：（本地配置覆盖远程 本地配置优先）
spring:
  cloud:
    config:
      override-none: true
      allow-override: true
      override-system-properties: false

# 方式二原理：修改nacos配置序号，使之采用addLast加载而非addFirst，从而实现命令行参数优先级大于远程配置中心。
# 注意：该方案直接修改了nacos中所有配置优先级，使之从first变为last，可能存在风险，请慎用！

使用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程序启动参数

当微服务项目有多个模块时，本地Idea需要切换Nacos环境地址进行运行调试，正常情况需要修改全部模块的bootstrap.yml文件关于nacos的相关配置，此时操作就相当繁琐；这时候可以通过一个公共配置文件来处理当前问题。步骤如下：

1.创建外部文件(.env)定义环境变量

NACOS_CONFIG_NAMESPACE=test
NACOS_CONFIG_SERVER_ADDR=127.0.0.1:8848

2.在每个模块的运行/调试界面添加环境变量

文件类型	示例	说明
*.env	d:/data/test.env	手动选择指定的配置文件

3.在每个模块的运行/调试界面添加程序参数

--spring.cloud.nacos.config.namespace=${NACOS_CONFIG_NAMESPACE}
--spring.cloud.nacos.config.server-addr=${NACOS_CONFIG_SERVER_ADDR}

获取系统参数的方法

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

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

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

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

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

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