如何区分若依RuoYi不同环境下的配置文件

在实际项目中，往往需要针对开发、测试、生产等不同环境使用不同的配置。如果每次切换环境都手动修改spring.profiles.active，不仅繁琐，也容易出错。若依推荐结合Maven Profile的方式，在打包阶段自动选择并替换对应的配置，从而实现环境隔离与无侵入切换。

这种方式的核心思路是：
通过spring.profiles.active=@spring.profile@与 Maven 的profile机制联动，在打包时指定环境参数，由 Maven 自动完成配置注入。

一、在 pom.xml 中定义多环境配置

首先在项目的pom.xml中配置多个profile，分别对应不同运行环境，并为每个环境定义独立的属性值。

<profiles> <profile> <!-- 开发环境 --> <id>dev</id> <properties> <spring.profile>dev</spring.profile> <nacos.server.address>127.0.0.1:8848</nacos.server.address> </properties> <activation> <!-- 默认激活 --> <activeByDefault>true</activeByDefault> </activation> </profile> <profile> <!-- 测试环境 --> <id>test</id> <properties> <spring.profile>test</spring.profile> <nacos.server.address>120.120.120.120:8848</nacos.server.address> </properties> <activation> <activeByDefault>false</activeByDefault> </activation> </profile> <profile> <!-- 生产环境 --> <id>prod</id> <properties> <spring.profile>prod</spring.profile> <nacos.server.address>http://ruoyi.vip:8848</nacos.server.address> </properties> <activation> <activeByDefault>false</activeByDefault> </activation> </profile> </profiles>

同时需要开启资源过滤功能，使 Maven 在打包时能够替换配置文件中的占位符：

<build> <resources> <resource> <directory>src/main/resources</directory> <filtering>true</filtering> </resource> </resources> </build>

这样，Maven 在打包阶段就可以将配置文件中的变量替换为对应环境的实际值。

二、在配置文件中使用占位符

接下来修改application.yml或相关配置文件，将环境相关参数改为占位符形式：

# Tomcat server: port: 9201 # Spring spring: application: name: ruoyi-system profiles: # 当前激活环境（由 Maven 注入） active: @spring.profile@ cloud: nacos: discovery: # 服务注册地址 server-addr: @nacos.server.address@ config: # 配置中心地址 server-addr: @nacos.server.address@ file-extension: yml shared-configs: - application-${spring.profiles.active}.${spring.cloud.nacos.config.file-extension}

这里的@spring.profile@和@nacos.server.address@会在打包时，由 Maven 根据当前激活的profile自动替换。

三、通过 Maven Profile 进行打包

在完成以上配置后，即可通过 Maven 命令指定不同环境进行打包，而无需修改任何配置文件内容。

# 开发环境 mvn clean package -P dev # 测试环境 mvn clean package -Ptest # 生产环境 mvn clean package -P prod

例如，使用test环境进行打包时，配置文件中的：

@nacos.server.address@

会被自动替换为：

120.120.120.120:8848

从而生成完全适配测试环境的可运行包。

四、这种方式的优势

通过 Maven Profile 区分环境配置，具有以下明显优势：

• 无需频繁修改配置文件，降低人为操作风险

• 打包阶段即可确定运行环境，更符合 CI/CD 流程

• 各环境配置清晰隔离，便于维护与扩展

• 与若依微服务、Nacos 等组件天然契合

总结

在若依项目中，结合Maven Profile + Spring Profiles是一种成熟且推荐的多环境配置管理方案。通过在pom.xml中统一维护环境变量，并在配置文件中使用占位符，可以实现“一次配置，多环境复用”，既提升了开发效率，也增强了部署的规范性与安全性。