欢迎来到尧图网

客户服务 关于我们

您的位置:首页 > 汽车 > 时评 > Spring Boot 启动参数终极解析:如何优雅地控制你的应用?

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

2025/3/20 21:26:45 来源:https://blog.csdn.net/jiajia651304/article/details/146304824  浏览:    关键词:Spring Boot 启动参数终极解析:如何优雅地控制你的应用?

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

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

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

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


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

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.properties 里定义了 server.port=8080,命令行传递的 8081 仍然会覆盖它。


三、使用 application.propertiesapplication.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 应用中,我们可以通过 @ValueEnvironmentSystem.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

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

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

总结:最佳实践

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

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

版权声明:

本网仅为发布的内容提供存储空间,不对发表、转载的内容提供任何形式的保证。凡本网注明“来源:XXX网络”的作品,均转载自其它媒体,著作权归作者所有,商业转载请联系作者获得授权,非商业转载请注明出处。

我们尊重并感谢每一位作者,均已注明文章来源和作者。如因作品内容、版权或其它问题,请及时与我们联系,联系邮箱:809451989@qq.com,投稿邮箱:809451989@qq.com

热搜词