Spring Boot Kotlin测试中MockMvc无法自动注入问题求助

问题场景 #

使用Kotlin在Spring Boot中编写Rest Docs测试时，遇到MockMvc无法注入测试类的问题，报错提示NoSuchBeanDefinitionException: No qualifying bean of type 'org.springframework.test.web.servlet.MockMvc' available。已添加@AutoConfigureMockMvc、@AutoConfigureRestDocs、@ExtendWith(RestDocumentationExtension::class)注解，但问题依旧。

原因分析 #

1. Kotest Spring依赖范围错误：kotest-extensions-spring被配置为implementation，该依赖仅用于测试场景，应改为testImplementation，否则运行时无法正确加载Spring扩展。
2. 缺少Spring上下文加载注解：@AutoConfigureMockMvc需要结合Spring测试上下文注解（如@SpringBootTest或@WebMvcTest）才能生效，单独使用无法触发MockMvc Bean的创建。
3. JUnit Platform未启用：Kotest基于JUnit 5运行，build.gradle中注释掉了useJUnitPlatform()配置，导致Spring测试扩展无法正常工作。

解决方案 #

1. 修正依赖配置（build.gradle.kts） #

将kotest-extensions-spring的依赖范围从implementation改为testImplementation：

// 原配置
implementation("io.kotest:kotest-extensions-spring:4.4.3")
// 修改后
testImplementation("io.kotest:kotest-extensions-spring:4.4.3")

2. 启用JUnit Platform #

取消build.gradle.kts中测试任务的注释，启用JUnit Platform：

tasks.withType<Test> {
    useJUnitPlatform()
}

tasks.test {
    outputs.dir(snippetsDir)
}

3. 调整测试类注解 #

在测试类上添加@SpringBootTest（或针对Controller测试的@WebMvcTest），确保Spring上下文正确加载：

@SpringBootTest
@AutoConfigureMockMvc
@AutoConfigureRestDocs
@ExtendWith(RestDocumentationExtension::class)
class ControllerTest(
    private val mockMvc: MockMvc, // Kotlin构造函数注入可省略@Autowired
    @MockBean private val lectureService: LectureService,
) : BehaviorSpec({
    // 测试逻辑...
})

注：Kotlin中构造函数参数如果是Spring Bean，可省略@Autowired注解，Spring会自动完成注入。

验证 #

修改完成后重新运行测试，MockMvc应该能正常注入，Rest Docs测试可正常生成文档片段。

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