一文带你了解SpringBoot中启动参数的各种用法

本文主要是介绍一文带你了解SpringBoot中启动参数的各种用法，希望对大家解决编程问题提供一定的参考价值，需要的开发者们随着小编来一起学习吧！

《一文带你了解SpringBoot中启动参数的各种用法》在使用SpringBoot开发应用时,我们通常需要根据不同的环境或特定需求调整启动参数,那么,SpringBoot提供了哪些方式来配置这些启动参...

一、启动参数的常见传递方式

Spring Boot 允许我们通过以下几种方式传递启动参数：

方式	适用场景	示例
命令行参数	适用于临时修改配置	Java -jar app.jar --server.port=8081
application.properties/yml	适用于项目默认配置	server.port=8081
环境变量	适用于 docker/K8S 部署	export SERVER_PORT=8081
JVM 启动参数	适用于调整 JVM 运行时行为	-Xmx512m -Dspring.profiles.active=prod
System.getProperty() 读取	适用于自定义动态参数	System.getProperty("custom.param")

接下来，我们逐个解析这些方式的用法和示例代码。

二、通过命令行参数传递启动参数

最简单的方式是在启动 jar 文件时，使用 --参数名=值的格式来传递参数。

示例：修改 Spring Boot 端口

java -jar myapp.jar --server.port=8081

效果：应用启动后，监听的端口会变为 8081。

如果想传递多个参数，可以这样写：

java -jar myapp.jar --server.port=8081 --spring.application.name=myapp

注意：命令行参数的优先级比 application.properties 更高，即使 application.propewww.chinasem.cnrties 里定义了 server.port=8080，命令行传递的 8081 仍然会覆盖它。

三、使用 application.properties 或 application.yml 配置参数

Spring Boot 提供了 application.properties（或 application.yml）来管理应用配置，这种方式适用于默认参数配置。

示例：application.properties

server.port=8082
spring.application.name=myapp
logging.level.root=INFO

示例：application.yml

server:
  port: 8082
spring:
  application:
    name: myapp
logging:
  level:
    root: INFO

优点：

适用于长期配置，不用每次启动都传递参数。
配置清晰，可集中管理多个环境的参数。

缺点：

配置是静态的，运行时修改需要重启应用。www.chinasem.cn
无法动态传递参数。

四、使用环境变量传递参数

在 Docker 或 Kubernetes（K8S）等容器环境中，通常使用环境变量传递参数。Spring Boot 默认支持从环境变量读取参数。

示例：设置环境变量并启动应用

export SERVER_PORT=9090
export SPRING_APPLICATION_NAME=MySpringApp
java -jar myapp.jar

或者在 Windows cmd 中：

set SERVER_PORT=9090
java -jar myapp.jar

效果：Spring Boot 会自动读取 SERVER_PORT 并将其作为 server.port 的值，即应用会运行在 9090 端口。

五、使用 JVM 启动参数传递参数

如果我们希望在 JVM 层面传递参数，可以使用 -D 选项。

示例：指定运行环境

java -Dspring.profiles.active=prod -jar myapp.jar

在代码中可以这样获取：

String profile = System.getProperty("spring.profiles.active");
System.out.println("当前环境：" + profile);

示例：限制 JVM 内存

java -Xmx512m -Xms256m -jar myapp.jar

-Xmx512m：最大内存 512MB
-Xms256m：初始内存 256MB

应用场景：

适用于不同环境（开发、测试、生产）的参数切换。
适用于 JVM 级别的优化（如 GC、线程管理等）。

六、Spring Boot 读取启动参数的代码示例

在 Spring Boot 应用中，我们可以通过 @Value、China编程Environment 或 System.getProperty() 读取启动参数。

1. 通过 @Value 读取参数

import org.springframework.beans.factory.annotation.Value;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RestController;

@RestController
@RequestMapping("/config")
public class ConfigController {

    @Value("${server.port}")
    private String serverPort;

    @Value("${spring.application.name}")
    private String appName;

    @GetMapping("/info")
    public String getConfigInfo() {
        return "App: " + appName + ", Running on Port: " + serverPort;
    }
}

2. 通过 Environment 读取参数

import org.springframework.core.env.Environment;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RestController;

@RestController
public class EnvController {

    private fpythoninal Environment env;

    public EnvController(Environment env) {
        this.env = env;
    }

    @GetMapping("/env")
    public String getEnvInfo() {
        return "Profile: " + env.getProperty("spring.profiles.active") +
               ", Server Port: " + env.androidgetProperty("server.port");
    }
}

3. 通过 System.getProperty() 读取 JVM 级别参数

@GetMapping("/jvm")
public String getJvmParams() {
    return "JVM Param: " + System.getProperty("custom.param", "默认值");
}

如果我们用以下方式启动应用：

java -Dcustom.param=myValue -jar myapp.jar

那么 /jvm 接口会返回：

JVM Param: myValue

七、总结：如何选择合适的启动参数方式

方式	适用场景	是否可动态修改	优先级
命令行参数	适用于临时配置，如测试	✅	最高
application.properties	适用于默认配置	❌	低
环境变量	适用于容器化部署	✅	高
JVM 参数	适用于调整 JVM 行为	❌	高