Spring Boot Maven插件集成测试未加载指定配置文件问题

核心原因定位 #

springdoc-openapi-maven-plugin 默认使用主代码类路径（src/main/resources）启动Spring上下文，即便日志显示激活了ci profile，也不会自动加载src/test/resources下的测试配置；同时Spring Boot Maven Plugin的测试阶段配置可能未正确传递profile激活参数，导致配置加载异常。

具体修复步骤 #

1. 确认测试配置文件规范

   • 确保application-ci.properties放在src/test/resources目录下，且配置了有效的MongoDB连接字符串。

2. 调整springdoc-openapi-maven-plugin配置
   在pom.xml中给插件添加测试类路径引用和profile指定，强制加载测试环境配置：

   <plugin>
       <groupId>org.springdoc</groupId>
       <artifactId>springdoc-openapi-maven-plugin</artifactId>
       <version>1.4</version>
       <executions>
           <execution>
               <id>generate-openapi-docs</id>
               <goals>
                   <goal>generate</goal>
               </goals>
               <configuration>
                   <!-- 激活ci配置文件 -->
                   <profiles>ci</profiles>
                   <!-- 强制使用测试类路径，加载src/test/resources下的配置 -->
                   <useTestClasspath>true</useTestClasspath>
                   <!-- 自定义文档输出配置 -->
                   <outputFileName>openapi.json</outputFileName>
                   <outputDir>${project.build.directory}/docs</outputDir>
               </configuration>
           </execution>
       </executions>
       <dependencies>
           <!-- 引入测试依赖，确保插件能访问测试配置 -->
           <dependency>
               <groupId>org.springframework.boot</groupId>
               <artifactId>spring-boot-starter-test</artifactId>
               <version>2.5.7</version>
               <scope>test</scope>
           </dependency>
       </dependencies>
   </plugin>
   

3. 修正Spring Boot Maven Plugin测试阶段配置
   如果是通过插件启动应用执行集成测试，需显式传递profile激活参数：

   <plugin>
       <groupId>org.springframework.boot</groupId>
       <artifactId>spring-boot-maven-plugin</artifactId>
       <version>2.5.7</version>
       <executions>
           <execution>
               <id>pre-integration-test</id>
               <goals>
                   <goal>start</goal>
               </goals>
               <configuration>
                   <profiles>ci</profiles>
                   <jvmArguments>-Dspring.profiles.active=ci</jvmArguments>
               </configuration>
           </execution>
           <execution>
               <id>post-integration-test</id>
               <goals>
                   <goal>stop</goal>
               </goals>
           </execution>
       </executions>
   </plugin>
   

4. 排查配置优先级冲突

   • 检查命令行是否传递了其他spring.profiles.active参数，避免覆盖ci配置
   • 可在配置类中添加日志输出，验证实际加载的profile和配置路径：

     @Configuration
     public class ConfigChecker {
         @Value("${spring.profiles.active}")
         private String activeProfile;
         
         @PostConstruct
         public void logConfigInfo() {
             System.out.println("当前激活Profile: " + activeProfile);
             System.out.println("加载的配置文件路径: " + System.getProperty("spring.config.location"));
         }
     }
     

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