Spring Boot激活openapi Profile生成OpenAPI文件时配置加载异常求助

问题核心 #

尽管Spring的openapi Profile已激活，但Spring Boot的配置加载逻辑是优先加载默认配置文件（application.properties/application.yaml），再叠加对应Profile的配置文件。因此如果默认配置中存在未解析的${JDBC_DATABASE_URL}变量，即便application-openapi.yaml中没有相关配置，默认配置的残留项依然会触发数据源初始化错误。

具体解决方案 #

方案1：清理默认配置文件 #

将数据库相关配置从application.properties中移除，仅保留所有环境共用的基础配置项。数据库配置仅放在对应环境的Profile配置文件（如application-openapi.yaml）中。

如果必须保留默认配置中的数据库项，可给变量设置空默认值避免未解析报错：

JDBC_DATABASE_URL=${JDBC_DATABASE_URL:}

方案2：禁用数据源自动配置（OpenAPI生成场景推荐） #

若生成OpenAPI描述文件时无需连接数据库，可在application-openapi.yaml中添加自动配置排除项，跳过数据源初始化流程：

spring:
  autoconfigure:
    exclude: org.springframework.boot.autoconfigure.jdbc.DataSourceAutoConfiguration

方案3：验证Maven插件配置（可选） #

虽然日志已显示Profile激活，仍可确认spring-boot-maven-plugin是否正确传递了Profile参数。插件启动时应自动追加--spring.profiles.active=openapi参数，可通过Maven日志查看启动命令是否包含该参数。

相关配置与报错信息 #

Maven Profile配置（pom.xml） #

<profile>
    <id>openapi</id>
    <build>
        <plugins>
            <plugin>
                <groupId>org.springframework.boot</groupId>
                <artifactId>spring-boot-maven-plugin</artifactId>
                <configuration>
                    <profiles>
                        <profile>openapi</profile>
                    </profiles>
                </configuration>
                <executions>
                    <execution>
                        <id>pre-integration-test</id>
                        <goals>
                            <goal>start</goal>
                        </goals>
                    </execution>
                    <execution>
                        <id>post-integration-test</id>
                        <goals>
                            <goal>stop</goal>
                        </goals>
                    </execution>
                </executions>
            </plugin>
            <plugin>
                <groupId>org.springdoc</groupId>
                <artifactId>springdoc-openapi-maven-plugin</artifactId>
                <version>0.2</version>

                <executions>
                    <execution>
                        <phase>integration-test</phase>
                        <goals>
                            <goal>generate</goal>
                        </goals>
                    </execution>
                </executions>
            </plugin>

        </plugins>
    </build>
</profile>

Profile激活日志 #

[  restartedMain] com.example.server.Application  :  The following 1 profile is active: "openapi"

报错信息 #

Caused by: java.lang.RuntimeException: Driver org.postgresql.Driver claims to not accept jdbcUrl, ${JDBC_DATABASE_URL}
    at com.zaxxer.hikari.util.DriverDataSource.<init>(DriverDataSource.java:110) ~[HikariCP-5.0.1.jar:na]
    at com.zaxxer.hikari.pool.PoolBase.initializeDataSource(PoolBase.java:326) ~[HikariCP-5.0.1.jar:na]
    at com.zaxxer.hikari.pool.PoolBase.<init>(PoolBase.java:112) ~[HikariCP-5.0.1.jar:na]

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