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

 更新时间:2025年03月25日 11:24:10   作者:jiajia651304  
在使用 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.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

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

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

最佳实践

1.开发环境:使用 application.properties 作为默认配置。

2.测试环境:使用命令行参数或环境变量传递测试配置。

3.生产环境:使用 -Dspring.profiles.active=prod + 环境变量,实现动态配置管理。

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

到此这篇关于一文带你了解SpringBoot中启动参数的各种用法的文章就介绍到这了,更多相关SpringBoot启动参数内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家!

相关文章

  • 如何设置springboot启动端口

    如何设置springboot启动端口

    spring boot是个好东西,可以不用容器直接在main方法中启动,而且无需配置文件,方便快速搭建环境。下面给大家介绍springboot启动端口的设置方法和spring boot创建应用端口冲突8080 问题,感兴趣的朋友一起看看吧
    2017-08-08
  • Spring MVC内置过滤器功能示例详解

    Spring MVC内置过滤器功能示例详解

    这篇文章主要为大家介绍了Spring MVC内置过滤器使用示例详解,有需要的朋友可以借鉴参考下,希望能够有所帮助,祝大家多多进步,早日升职加薪
    2023-09-09
  • mybatis中嵌套使用foreach需要注意的坑

    mybatis中嵌套使用foreach需要注意的坑

    在使用MyBatis进行数据库操作时,如果需要在一个大的foreach标签中嵌套另一个foreach,需要注意内层foreach的item属性不能与外层重复,如果出现重复,会导致绑定参数时找不到正确的参数,从而抛出异常
    2024-09-09
  • 深入理解Java中的类加载器原理

    深入理解Java中的类加载器原理

    这篇文章主要介绍了深入理解Java中的类加载器原理,类加载器负责加载所有的类,系统为所有被载入内存中的类生成一个java.lang.Class实例,需要的朋友可以参考下
    2024-01-01
  • Java与Python之间使用jython工具类实现数据交互

    Java与Python之间使用jython工具类实现数据交互

    今天小编就为大家分享一篇关于Java与Python之间使用jython工具类实现数据交互,小编觉得内容挺不错的,现在分享给大家,具有很好的参考价值,需要的朋友一起跟随小编来看看吧
    2019-03-03
  • JAVA 实现磁盘文件加解密操作的示例代码

    JAVA 实现磁盘文件加解密操作的示例代码

    这篇文章主要介绍了JAVA 实现磁盘文件加解密操作的示例代码,帮助大家利用Java实现文件的加解密,感兴趣的朋友可以了解下
    2020-09-09
  • Java 线程池的作用以及该如何使用

    Java 线程池的作用以及该如何使用

    这篇文章主要介绍了Java 线程池的作用以及该如何使用,帮助大家更好的理解和学习Java的相关知识,感兴趣的朋友可以了解下
    2021-01-01
  • Java中Dom4j的配置与使用示例详解

    Java中Dom4j的配置与使用示例详解

    Dom4j是一个强大的Java库,用于处理XML数据,结合了DOM、SAX、JDOM的优点,它可以解析、生成、修改和序列化XML文档,适用于数据交换、配置文件管理、日志记录、数据持久化和Web服务等场景,Dom4j提供了简单易用的API,便于开发者进行高效的XML操作
    2024-10-10
  • Java运算符的常见问题与用法小结

    Java运算符的常见问题与用法小结

    这篇文章主要介绍了Java运算符,结合实例形式总结分析了Java各种常见运算符,包括算术运算符、比较运算符、逻辑运算符、位运算符等相关功能、原理与使用技巧,需要的朋友可以参考下
    2020-04-04
  • SpringBoot2 整合MinIO中间件实现文件便捷管理功能

    SpringBoot2 整合MinIO中间件实现文件便捷管理功能

    这篇文章主要介绍了SpringBoot2 整合MinIO中间件,实现文件便捷管理,本文通过实例代码给大家介绍的非常详细,对大家的学习或工作具有一定的参考借鉴价值,需要的朋友可以参考下
    2020-07-07

最新评论