Spring Boot Maven传环境变量、读.env及调试相关问题咨询

核心参数差异说明 #

• mvn spring-boot:run -Dspring-boot.run.jvmArguments=...：传递JVM级参数，包含系统属性（-Dkey=value格式）、调试参数等，Spring可通过System.getProperty()读取，或自动映射到配置属性。
• mvn spring-boot:run -Dspring-boot.run.arguments=...：传递应用启动参数，即main方法接收的args数组，通常用--key=value格式，Spring Boot会绑定到对应配置属性。

场景1：直接通过Maven命令传递环境变量运行/调试 #

运行应用 #

直接在JVM参数中指定环境变量（系统属性形式）：

mvn spring-boot:run -Dspring-boot.run.jvmArguments="-DDB_NAME=demo -DDB_USERNAME=postgres -DDB_PASSWORD=pass -DJWT_SECRET=appSecretKey"

调试应用 #

在JVM参数中加入调试端口配置，同时传递环境变量：

mvn spring-boot:run -Dspring-boot.run.jvmArguments="-Xdebug -Xrunjdwp:transport=dt_socket,server=y,suspend=n,address=5005 -DDB_NAME=demo -DDB_USERNAME=postgres -DDB_PASSWORD=pass -DJWT_SECRET=appSecretKey"

说明：address=5005是调试端口；suspend=n表示启动后直接运行，若需等待调试器连接，改为suspend=y。

场景2：读取.env/.env-dev文件运行/调试 #

Spring Boot默认不直接支持.env文件，以下提供两种跨平台/平台专属实现方式：

方式1：系统环境变量加载（Unix/Linux/macOS） #

先将.env文件内容导出为系统环境变量，再启动应用：

# 加载.env文件
export $(cat .env | xargs) && mvn spring-boot:run

# 加载.env-dev文件
export $(cat .env-dev | xargs) && mvn spring-boot:run

Spring Boot会自动读取系统环境变量并映射到对应配置属性（如DB_NAME对应db.name，需与你的配置文件规则匹配）。

方式2：Maven插件加载（跨平台） #

1. 在pom.xml中添加properties-maven-plugin，用于读取.env文件到Maven属性：

<plugin>
    <groupId>org.codehaus.mojo</groupId>
    <artifactId>properties-maven-plugin</artifactId>
    <version>1.0.0</version>
    <executions>
        <execution>
            <phase>initialize</phase>
            <goals>
                <goal>read-project-properties</goal>
            </goals>
            <configuration>
                <files>
                    <file>.env</file>
                </files>
            </configuration>
        </execution>
    </executions>
</plugin>

2. 若需切换.env-dev，可配置Maven Profile实现环境快速切换：

<profiles>
    <profile>
        <id>dev</id>
        <build>
            <plugins>
                <plugin>
                    <groupId>org.codehaus.mojo</groupId>
                    <artifactId>properties-maven-plugin</artifactId>
                    <version>1.0.0</version>
                    <executions>
                        <execution>
                            <phase>initialize</phase>
                            <goals>
                                <goal>read-project-properties</goal>
                            </goals>
                            <configuration>
                                <files>
                                    <file>.env-dev</file>
                                </files>
                            </configuration>
                        </execution>
                    </executions>
                </plugin>
            </plugins>
        </build>
    </profile>
</profiles>

3. 运行/调试命令示例：

• 加载.env运行：

mvn spring-boot:run -Dspring-boot.run.jvmArguments="-DDB_NAME=${DB_NAME} -DDB_USERNAME=${DB_USERNAME} -DDB_PASSWORD=${DB_PASSWORD} -DJWT_SECRET=${JWT_SECRET}"

• 加载.env-dev运行：

mvn spring-boot:run -Pdev -Dspring-boot.run.jvmArguments="-DDB_NAME=${DB_NAME} -DDB_USERNAME=${DB_USERNAME} -DDB_PASSWORD=${DB_PASSWORD} -DJWT_SECRET=${JWT_SECRET}"

• 加载.env-dev调试：

mvn spring-boot:run -Pdev -Dspring-boot.run.jvmArguments="-Xdebug -Xrunjdwp:transport=dt_socket,server=y,suspend=n,address=5005 -DDB_NAME=${DB_NAME} -DDB_USERNAME=${DB_USERNAME} -DDB_PASSWORD=${DB_PASSWORD} -DJWT_SECRET=${JWT_SECRET}"

内容的提问来源于stack exchange，提问作者Jack