WireMock是否支持GraphQL API Mock？Spring Boot微服务集成测试问询

1. WireMock是否支持GraphQL？ #

完全支持。GraphQL本质是基于HTTP POST请求（通常指向/graphql端点），请求体为包含query或mutation的JSON结构。WireMock可以通过匹配请求路径和请求体内容，实现GraphQL接口的Stubbing，和处理REST接口的核心逻辑一致。

2. Spring Boot环境下的实现步骤 #

（1）添加依赖 #

在项目的pom.xml（Maven）或build.gradle（Gradle）中引入WireMock测试依赖：

<!-- Maven 示例 -->
<dependency>
    <groupId>com.github.tomakehurst</groupId>
    <artifactId>wiremock-jre8</artifactId>
    <version>2.35.0</version>
    <scope>test</scope>
</dependency>

（2）编写GraphQL Stub逻辑 #

以下是Stub一个用户查询GraphQL接口的示例代码：

import com.github.tomakehurst.wiremock.WireMockServer;
import static com.github.tomakehurst.wiremock.client.WireMock.*;

class GraphQLWireMockTest {
    private WireMockServer wireMockServer;

    @BeforeEach
    void setUp() {
        wireMockServer = new WireMockServer(8081); // 指定WireMock运行端口
        wireMockServer.start();
        configureFor("localhost", 8081);
    }

    @AfterEach
    void tearDown() {
        wireMockServer.stop();
    }

    @Test
    void testGraphQLStubbing() {
        // 定义要匹配的GraphQL请求体
        String graphqlRequest = "{ \"query\": \"query GetUser($id: ID!) { user(id: $id) { id name email } }\", \"variables\": { \"id\": \"123\" } }";
        
        // 配置Stub规则
        stubFor(post(urlEqualTo("/graphql"))
                .withRequestBody(equalToJson(graphqlRequest))
                .willReturn(aResponse()
                        .withStatus(200)
                        .withHeader("Content-Type", "application/json")
                        .withBody("{ \"data\": { \"user\": { \"id\": \"123\", \"name\": \"张三\", \"email\": \"zhangsan@example.com\" } } }")));
        
        // 此处调用你的Spring Boot服务中调用该GraphQL接口的业务方法，验证返回结果符合预期
    }
}

（3）进阶匹配技巧 #

• 宽松匹配请求体：使用equalToJson(graphqlRequest, true, true)忽略空格和字段顺序，适配不同格式的请求
• 仅匹配查询片段：用matchingJsonPath("$.query", containing("GetUser"))只校验query中的关键字，不严格匹配变量
• Mutation请求适配：逻辑和查询完全一致，只需替换请求体中的mutation内容即可

3. 关键注意事项 #

• 确保Spring Boot服务的测试配置中，外部GraphQL服务的地址指向WireMock的运行端口（例如配置graphql.base-url=http://localhost:8081）
• 可通过WireMock的录制功能快速生成Stub：用wireMockServer.record(recordSpec().forTarget("真实GraphQL服务地址"))录制真实请求，自动生成匹配规则

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