Spring Boot WebFlux中Thymeleaf控制器视图的集成测试问询

WebTestClient完全支持测试WebFlux环境下的Thymeleaf视图控制器，你遇到的404错误大概率是配置或测试设置问题，而非工具本身不支持。下面是具体的解决方案：

1. 确保依赖齐全 #

除了WebFlux依赖，必须引入Thymeleaf的Spring Boot Starter，否则视图解析器无法正常工作。在pom.xml（Maven）或build.gradle.kts（Gradle）中添加：

<!-- Maven -->
<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-thymeleaf</artifactId>
</dependency>

// Gradle
implementation("org.springframework.boot:spring-boot-starter-thymeleaf")

同时确保测试依赖包含spring-boot-starter-test，它自带WebTestClient的支持。

2. 正确编写测试类 #

使用@WebFluxTest注解指定要测试的控制器，配合@MockBean模拟依赖的服务，避免测试依赖外部资源。示例代码如下：

import org.junit.jupiter.api.Test
import org.springframework.beans.factory.annotation.Autowired
import org.springframework.boot.test.autoconfigure.web.reactive.WebFluxTest
import org.springframework.boot.test.mock.mockito.MockBean
import org.springframework.http.MediaType
import org.springframework.test.web.reactive.server.WebTestClient
import org.mockito.kotlin.whenever

@WebFluxTest(CustomerController::class)
class CustomerControllerTest {

    @Autowired
    private lateinit var webTestClient: WebTestClient

    @MockBean
    private lateinit var customerService: CustomerService

    @Test
    fun `getCustomerView returns valid HTML view`() {
        // 模拟服务返回的客户数据
        val mockCustomer = Customer(id = 1, name = "Alice Smith")
        whenever(customerService.getCustomer()).thenReturn(mockCustomer)

        webTestClient.get()
            .uri("/customer-view")
            .accept(MediaType.TEXT_HTML)
            .exchange()
            // 断言响应状态
            .expectStatus().isOk
            // 断言响应内容类型
            .expectHeader().contentTypeCompatibleWith(MediaType.TEXT_HTML)
            // 验证视图渲染的内容
            .expectBody(String::class.java)
            .consumeWith { result ->
                val htmlContent = result.responseBody!!
                assert(htmlContent.contains("Alice Smith"))
                assert(htmlContent.contains("customer-view")) // 可根据视图模板内容调整断言
            }
    }
}

3. 排查404错误的常见原因 #

• 视图文件路径错误：确保src/main/resources/templates/目录下存在customer-view.html文件
• 路由路径不匹配：检查控制器@GetMapping的路径和测试中uri()的参数是否完全一致
• 视图解析器未生效：确认Thymeleaf依赖已正确引入，Spring Boot会自动配置视图解析器，无需额外配置

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