Spring Boot 启动参数终极解析：如何优雅地控制你的应用？

Spring Boot 启动参数终极解析：如何优雅地控制你的应用？

在使用 Spring Boot 开发应用时，我们通常需要根据不同的环境（开发、测试、生产）或特定需求调整启动参数，例如：

• 修改默认端口
• 指定不同的配置文件
• 控制 JVM 内存大小
• 传递自定义参数

那么，Spring Boot 提供了哪些方式来配置这些启动参数？今天我们就来详细解析 Spring Boot 启动参数的各种用法，并附带代码示例，让你可以灵活掌控应用的启动过程。

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

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

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

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

最简单的方式是在启动 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.properties 里定义了 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

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

缺点：

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

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

在 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、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 final Environment env;

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

    @GetMapping("/env")
    public String getEnvInfo() {
        return "Profile: " + env.getProperty("spring.profiles.active") +
               ", Server Port: " + env.getProperty("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

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

总结：最佳实践

1️⃣ 开发环境：使用 application.properties 作为默认配置。
2️⃣ 测试环境：使用命令行参数或环境变量传递测试配置。
3️⃣ 生产环境：使用 -Dspring.profiles.active=prod + 环境变量，实现动态配置管理。

🚀 掌握 Spring Boot 启动参数，你的应用将更加灵活高效！ 🎯