执行请求

DeepSeek V3 中英对照 Performing Requests

本节展示了如何单独使用 MockMvc 来执行请求并验证响应。如果通过 WebTestClient 使用 MockMvc，请参阅 编写测试 中的相应部分。

要执行使用任何 HTTP 方法的请求，如下例所示：

Java

// static import of MockMvcRequestBuilders.*

mockMvc.perform(post("/hotels/{id}", 42).accept(MediaType.APPLICATION_JSON));

java

Kotlin

import org.springframework.test.web.servlet.post

mockMvc.post("/hotels/{id}", 42) {
    accept = MediaType.APPLICATION_JSON
}

kotlin

你也可以执行文件上传请求，这些请求在内部使用 MockMultipartHttpServletRequest，因此实际上不会解析多部分请求。相反，你需要将其设置为类似于以下示例：

Java

mockMvc.perform(multipart("/doc").file("a1", "ABC".getBytes("UTF-8")));

java

Kotlin

import org.springframework.test.web.servlet.multipart

mockMvc.multipart("/doc") {
    file("a1", "ABC".toByteArray(charset("UTF8")))
}

kotlin

你可以在 URI 模板样式中指定查询参数，如下例所示：

Java

mockMvc.perform(get("/hotels?thing={thing}", "somewhere"));

java

Kotlin

mockMvc.get("/hotels?thing={thing}", "somewhere")

kotlin

你还可以添加代表查询参数或表单参数的 Servlet 请求参数，如下例所示：

Java

mockMvc.perform(get("/hotels").param("thing", "somewhere"));

java

Kotlin

import org.springframework.test.web.servlet.get

mockMvc.get("/hotels") {
    param("thing", "somewhere")
}

kotlin

如果应用程序代码依赖于 Servlet 请求参数并且没有显式检查查询字符串（大多数情况下都是如此），那么你使用哪种选项并不重要。然而，请记住，通过 URI 模板提供的查询参数会被解码，而通过 param(…​) 方法提供的请求参数则预期已经是解码后的。

在大多数情况下，最好将上下文路径（context path）和 Servlet 路径（servlet path）从请求 URI 中排除。如果必须使用完整的请求 URI 进行测试，请确保相应地设置 contextPath 和 servletPath，以便请求映射正常工作，如下例所示：

Java

mockMvc.perform(get("/app/main/hotels/{id}").contextPath("/app").servletPath("/main"))

java

Kotlin

import org.springframework.test.web.servlet.get

mockMvc.get("/app/main/hotels/{id}") {
    contextPath = "/app"
    servletPath = "/main"
}

kotlin

在前面的示例中，每次执行请求时设置 contextPath 和 servletPath 会非常繁琐。相反，你可以设置默认的请求属性，如下例所示：

Java

class MyWebTests {

    MockMvc mockMvc;

    @BeforeEach
    void setup() {
        mockMvc = standaloneSetup(new AccountController())
            .defaultRequest(get("/")
            .contextPath("/app").servletPath("/main")
            .accept(MediaType.APPLICATION_JSON)).build();
    }
}

java

Kotlin

// Not possible in Kotlin until {kotlin-issues}/KT-22208 is fixed

kotlin

前面的属性会影响通过 MockMvc 实例执行的每个请求。如果在给定的请求上也指定了相同的属性，它将覆盖默认值。这就是为什么默认请求中的 HTTP 方法和 URI 无关紧要，因为它们必须在每个请求上指定。