如何在 IDEA 中在启动 Spring Boot 项目时加参数

在日常开发中，我们经常需要在启动 Spring Boot 项目的时候，临时修改一些参数，例如 端口号、运行环境（profile）、日志级别 等等。除了在 application.yml 文件里修改，我们还可以通过在 IDEA 启动配置中添加参数的方式来实现。这种方式更加灵活，适合临时调试或者本地开发时使用。

本文将详细介绍在 IDEA 中为 Spring Boot 启动项目加参数的方法。

---

一、在 application.yml 中配置端口号（默认方式）

在 application.yml 文件中可以直接写配置，例如修改端口号：

server:
  port: 8080

启动时项目会监听 8080 端口。
不过这种方式是写死在配置文件里的，如果要频繁切换端口或者测试不同环境，就不够灵活了。

---

二、通过 IDEA 启动配置添加参数

在 IDEA 里，点击右上角的运行/调试配置，选择 Edit Configurations，可以看到两个常用的参数输入框：

• VM Options
• Program arguments

这两者都可以传参，但作用范围不同。

---

1. VM Options（JVM 参数）

在 VM Options 中添加参数时，使用 -D 前缀，例如：

-Dserver.port=8082 -Dspring.profiles.active=dev -Dlogging.level.root=DEBUG

特点：

• -Dkey=value 形式，会作为 JVM 系统属性。
• Spring Boot 会自动读取并覆盖配置文件里的值。
• 也可以用来配置一些 JVM 相关的参数（比如内存、GC 等）。

等价于在代码中调用：

System.getProperty("server.port");

---

2. Program arguments（程序参数）

在 Program arguments 中添加参数时，使用 -- 前缀，例如：

--server.port=8083 --spring.profiles.active=test --logging.level.root=DEBUG

特点：

• --key=value 形式，Spring Boot 启动时会自动解析。
• 用来覆盖 application.yml 或 application.properties 中的配置。
• 常用来传递业务相关参数，例如运行环境、端口号、日志级别等。

---

三、优先级说明

Spring Boot 对配置的加载有优先级，大体顺序如下（从低到高）：

1. application.yml / application.properties（默认配置文件）
2. application-{profile}.yml（不同环境的配置文件，例如 application-dev.yml）
3. Program arguments（--server.port=8083）
4. VM Options（-Dserver.port=8082）

👉 如果同一个参数在多个地方都设置了，优先级高的会覆盖低的。
比如：在 application.yml 中设置端口是 8080，在 Program arguments 中传 --server.port=8083，最终端口就是 8083。

---

四、推荐用法

• 业务参数（端口、profile、日志级别等）：用 --，写在 Program arguments。
• JVM 参数（堆大小、GC 配置、系统属性等）：用 -D，写在 VM Options。

这样既符合习惯，也便于区分不同类型的配置。

---

五、总结

在 IDEA 中启动 Spring Boot 项目时，可以通过以下方式传递参数：

1. 修改配置文件（application.yml）：适合固定配置。
2. VM Options（-D）：传递 JVM 系统属性或 Spring Boot 参数。
3. Program arguments（–）：传递 Spring Boot 参数，覆盖配置文件。

通过合理使用这三种方式，就能更加灵活地控制 Spring Boot 项目的启动参数。

---