【工具知识】在 Spring Boot 项目中结合 IntelliJ IDEA 实现不同环境配置文件选择-编程阁

在 Spring Boot 项目中结合 IntelliJ IDEA 实现不同环境配置文件选择

- - **一、准备工作：创建多环境配置文件**
  - **二、IDEA 中手工选择激活配置文件（核心步骤）**
  - - **步骤 1：打开运行/调试配置界面**
    - **步骤 2：创建/修改 Spring Boot 运行配置**
    - - **方式 1：通过 Program arguments 指定（推荐）**
      - **方式 2：通过 VM options 指定**
    - **步骤 3：创建多环境配置（可选，一键切换）**
    - **步骤 4：启动并验证**
  - **三、进阶技巧：通过 Maven/Gradle 插件激活（可选）**
  - - **Maven 项目**
    - **Gradle 项目**
  - **四、注意事项**
  - **总结**

在 Spring Boot 项目中结合 IntelliJ IDEA 实现手工选择激活不同环境的配置文件（如dev、test、prod），核心是通过 IDEA 的运行/调试配置动态指定spring.profiles.active参数，覆盖默认配置。以下是详细步骤：

一、准备工作：创建多环境配置文件

首先在src/main/resources目录下创建不同环境的配置文件，命名规则为application-{profile}.properties（或.yml）：

src/main/resources/ ├── application.properties # 默认配置（可选，存放公共配置） ├── application-dev.properties # 开发环境配置 ├── application-test.properties # 测试环境配置 └── application-prod.properties # 生产环境配置

示例配置（application-dev.properties）：

server.port=8081 app.name=MyApp-Dev logging.level.root=DEBUG

示例配置（application-prod.properties）：

server.port=80 app.name=MyApp-Prod logging.level.root=INFO

二、IDEA 中手工选择激活配置文件（核心步骤）

通过 IDEA 的运行/调试配置，为每个环境创建独立的启动参数，实现“一键切换”。

步骤 1：打开运行/调试配置界面

点击 IDEA 顶部菜单栏的Run → Edit Configurations…（或右上角运行按钮旁的下拉菜单 → Edit Configurations…）。

步骤 2：创建/修改 Spring Boot 运行配置

在左侧面板选择你的 Spring Boot 启动类（如DemoApplication），或通过+ → Spring Boot新建配置。
在右侧配置面板中，找到Configuration标签页，重点修改以下参数：

方式 1：通过 Program arguments 指定（推荐）

在Program arguments中添加--spring.profiles.active=环境名（如--spring.profiles.active=dev）：

--spring.profiles.active=dev

!https://img-blog.csdnimg.cn/img_convert/7a3b3d3c4d4e5f6a7b8c9d0e1f2a3b4c.png

方式 2：通过 VM options 指定

在VM options中添加-Dspring.profiles.active=环境名（如-Dspring.profiles.active=test）：

-Dspring.profiles.active=test

步骤 3：创建多环境配置（可选，一键切换）

若需频繁切换环境，可创建多个运行配置，每个配置对应一个环境：

在Edit Configurations界面点击左上角+，选择Spring Boot，命名为App-Dev。
配置Main class（启动类），并在Program arguments中添加--spring.profiles.active=dev。
重复上述步骤，创建App-Test（--spring.profiles.active=test）、App-Prod（--spring.profiles.active=prod）。

!https://img-blog.csdnimg.cn/img_convert/9e8f7a6b5c4d3e2f1a0b9c8d7e6f5a4b.png

步骤 4：启动并验证

选择配置：在 IDEA 右上角的运行按钮旁，通过下拉菜单选择刚创建的配置（如App-Dev）。
启动应用：点击运行按钮（▶️），观察控制台日志，确认激活的 Profile：
```
The following 1 profile is active: "dev" # 日志中会显示激活的环境
```
验证配置：访问http://localhost:8081（dev 环境端口），或通过 Actuator 端点/actuator/env查看生效配置。

三、进阶技巧：通过 Maven/Gradle 插件激活（可选）

若项目使用 Maven/Gradle 构建，也可通过 IDEA 的构建工具面板激活 Profile（需注意与 Spring Boot Profile 的对应关系）。

Maven 项目

在pom.xml中配置 Profiles：

<profiles><profile><id>dev</id><properties><spring.profiles.active>dev</spring.profiles.active></properties></profile><profile><id>prod</id><properties><spring.profiles.active>prod</spring.profiles.active></properties></profile></profiles>

在 IDEA 右侧Maven工具栏中，展开Profiles，勾选对应环境（如dev），启动时会自动传递参数。

Gradle 项目

在build.gradle中配置：

bootRun{systemProperty"spring.profiles.active",System.getProperty("spring.profiles.active","dev")}

在 IDEA 的Gradle工具栏中，通过Tasks → application → bootRun右键选择Modify Run Configuration，添加 VM options：-Dspring.profiles.active=test。

四、注意事项

优先级：命令行参数（Program arguments）> VM options > 配置文件中的spring.profiles.active> 环境变量。
配置文件优先级：application-{profile}.properties会覆盖application.properties中的同名配置。
IDEA 版本差异：低版本 IDEA 界面可能略有不同，但核心参数（Program arguments、VM options）位置一致。

总结

通过 IDEA 的运行配置手工选择激活 Spring Boot 配置文件，核心是在Program arguments或VM options中添加--spring.profiles.active=环境名。推荐创建多个运行配置对应不同环境，实现“一键切换”，提升开发效率。验证时通过启动日志和控制台输出确认激活的环境即可。