Spring Boot在IDEA可运行但mvn install因JDBC URL错误失败

问题根源 #

1. IDEA中配置的环境变量仅作用于IDE启动的进程，而mvn clean install是独立终端进程，不会自动继承这些变量。
2. Maven Surefire插件执行测试时，默认不会传递系统环境变量；当测试启动Spring上下文时，application.properties里的${DB_URL}等占位符因无对应环境变量，会被直接当作字符串使用，导致数据源URL不符合jdbc格式要求，触发报错。

解决方案 #

方法1：终端执行Maven命令时直接传入环境变量 #

在执行Maven命令前，先指定环境变量（不同系统语法有差异）：

• Linux/macOS终端：

DB_URL=jdbc:mysql://localhost:3307/user?createIfNotExists=true&serverTimezone=UTC DB_USER=root DB_PW=123456 mvn clean install

• Windows CMD：

set DB_URL=jdbc:mysql://localhost:3307/user?createIfNotExists=true&serverTimezone=UTC&&set DB_USER=root&&set DB_PW=123456&&mvn clean install

• Windows PowerShell：

$env:DB_URL="jdbc:mysql://localhost:3307/user?createIfNotExists=true&serverTimezone=UTC"; $env:DB_USER="root"; $env:DB_PW="123456"; mvn clean install

方法2：配置Surefire插件传递环境变量 #

在pom.xml中给Surefire插件添加环境变量配置，让测试进程能获取到变量：

<build>
    <plugins>
        <plugin>
            <groupId>org.apache.maven.plugins</groupId>
            <artifactId>maven-surefire-plugin</artifactId>
            <version>3.2.5</version> <!-- 建议使用最新稳定版本 -->
            <configuration>
                <environmentVariables>
                    <DB_URL>jdbc:mysql://localhost:3307/user?createIfNotExists=true&serverTimezone=UTC</DB_URL>
                    <DB_USER>root</DB_USER>
                    <DB_PW>123456</DB_PW>
                </environmentVariables>
            </configuration>
        </plugin>
    </plugins>
</build>

⚠️ 注意：这种方式会把数据库密码等敏感信息硬编码到pom.xml，仅适合本地测试，不要提交到公共代码仓库。

方法3：用Maven Profile管理多环境配置 #

通过Profile定义不同环境的数据库配置，避免硬编码敏感信息：

1. 在pom.xml中添加Profile：

<profiles>
    <profile>
        <id>local</id>
        <properties>
            <db.url>jdbc:mysql://localhost:3307/user?createIfNotExists=true&serverTimezone=UTC</db.url>
            <db.user>root</db.user>
            <db.pw>123456</db.pw>
        </properties>
    </profile>
</profiles>

2. 修改application.properties，使用Maven属性占位符：

spring.datasource.url=@db.url@
spring.datasource.username=@db.user@
spring.datasource.password=@db.pw@

3. 启用Maven资源过滤，确保占位符被替换：

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

4. 执行Maven命令时激活对应Profile：

mvn clean install -P local

这种方式适合多环境切换，且敏感信息可通过私有settings.xml进一步隔离。

方法4：在IDEA中配置Maven运行环境的环境变量 #

如果习惯用IDEA执行Maven命令，可直接在Maven运行配置中添加环境变量：

1. 打开Run/Debug Configurations → 找到或新建Maven配置
2. 在Environment variables栏添加DB_URL、DB_USER、DB_PW三个变量及对应值
3. 保存后执行Maven命令，环境变量会自动传递给Maven进程

额外建议 #

• 单元测试尽量使用切片注解（如@DataJpaTest、@WebMvcTest），避免启动完整Spring上下文，减少不必要的数据源依赖。
• 生产环境禁止在代码中打印数据库密码等敏感信息，及时移除主类中的System.out.println相关代码。

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