Spring Boot 3集成Gradle jvm-test-suite插件时集成测试报空指针错误

问题根源 #

报错核心是Spring Boot测试上下文无法找到带@SpringBootApplication的主启动类，导致findConfigurationClass方法返回null触发空指针异常。主要由两个原因导致：

• 测试类与主应用类的包结构不匹配，@SpringBootTest无法自动扫描到启动类
• Gradle的jvm-test-suite配置错误，测试类无法正常访问主应用的编译产物

解决方案 #

1. 对齐测试类与主应用类的包结构

如果主启动类是com.example.DemoApplication，测试类DemoApplicationTests需放在com.example包下。若必须使用不同包，需在@SpringBootTest中显式指定启动类：

import org.junit.jupiter.api.Test;
import org.springframework.boot.test.context.SpringBootTest;
import com.example.DemoApplication;

@SpringBootTest(classes = DemoApplication.class)
class DemoApplicationTests {

    @Test
    void contextLoads() {
    }
}

2. 修正Gradle jvm-test-suite配置

原配置存在两个关键问题：测试依赖误用implementation而非testImplementation，以及configureEach导致的重复配置。修改后的完整配置如下：

plugins {
    id 'java'
    id 'jvm-test-suite'
    id 'org.springframework.boot' version '3.0.0'
    id 'io.spring.dependency-management' version '1.1.0'
}

group = 'com.example'
version = '0.0.1-SNAPSHOT'
sourceCompatibility = '17'

repositories {
    mavenCentral()
}

ext {
    set('testcontainersVersion', "1.17.6")
}

dependencies {
    implementation 'org.springframework.boot:spring-boot-starter-data-mongodb'
    implementation 'org.springframework.boot:spring-boot-starter-web'
}

dependencyManagement {
    imports {
        mavenBom "org.testcontainers:testcontainers-bom:${testcontainersVersion}"
    }
}

testing {
    suites {
        // 配置默认单元测试套件
        test {
            useJUnitJupiter()
            dependencies {
                testImplementation 'org.springframework.boot:spring-boot-starter-test'
            }
        }

        // 配置集成测试套件
        integrationTest(JvmTestSuite) {
            useJUnitJupiter()
            dependencies {
                testImplementation project()
                testImplementation 'org.springframework.boot:spring-boot-starter-test'
                testImplementation 'org.testcontainers:junit-jupiter'
                testImplementation 'org.testcontainers:mongodb'
            }
            // 指定集成测试的源码和资源目录
            sources {
                java {
                    srcDir file('src/integration-test/java')
                }
                resources {
                    srcDir file('src/integration-test/resources')
                }
            }
        }
    }
}

// 将集成测试任务绑定到check阶段
tasks.named('check') {
    dependsOn testing.suites.integrationTest
}

3. 确认集成测试目录结构

确保目录符合Gradle规范：

src/
├── main/
│   └── java/com/example/DemoApplication.java
└── integration-test/
    ├── java/com/example/DemoApplicationTests.java
    └── resources/

验证修复 #

运行集成测试任务：

./gradlew integrationTest

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