使用PactV3测试GraphQL接口失败（报500内部服务器错误）

问题场景 #

在消费者端用Pact-JS v3构建契约时，因官方暂不支持GraphQL测试，只能通过模拟POST请求的原始Body实现。但只要在.withRequest方法中添加body属性，就会触发Http failure response for http://127.0.0.1:4000/product/graphql: 500 Internal Server Error；移除body后Mock服务正常，但生成的契约缺少请求Body完全失去意义。试过多种写法都失败：

.withRequest({
  method: 'POST',
  path: `/product/graphql`,
  headers: {
    'Content-Type': 'application/json',
    Accept: "application/json",
  },

  /*
   * Adding a body to the request fails with:
   * `Http failure response for http://127.0.0.1:4000/product/graphql: 500 Internal Server Error`
   *
   * The goal is to have the request body in the created Pact, because without it, it is
   * quite useless.
   */
  // body: requestBody,                                     // fails
  // body: MatchersV3.like(requestBody),                    // fails
  // body: MatchersV3.string(JSON.stringify(requestBody)),  // fails
})

解决步骤及要点 #

1. 匹配器与Body结构严格对应 #

Pact v10对application/json类型的请求Body校验非常严格，必须确保契约中定义的Body结构和实际发送的请求结构完全匹配，且使用正确的V3匹配器：

• 禁止用JSON.stringify把Body转成字符串传给匹配器，这会导致Content-Type与Body类型不匹配
• 嵌套对象要单独用MatchersV3.like()包裹，确保层级匹配

2. 正确的Body写法示例 #

根据GraphQL请求的常规结构（包含query和variables字段），修改body部分为：

body: {
  query: MatchersV3.string(requestBody.query), // 精确匹配查询字符串
  variables: MatchersV3.like(requestBody.variables) // 模糊匹配变量对象
}

如果请求Body是单个完整对象，也可以直接用like包裹整个结构：

body: MatchersV3.like(requestBody)

注意：这里的requestBody必须是未经过字符串化的原始JSON对象，和实际请求发送的结构完全一致。

3. 额外检查项 #

• 确认请求头的Content-Type确实是application/json，无拼写错误
• 运行测试前清空Pact的临时缓存目录，避免旧契约残留导致校验失败
• 核对实际发送的请求是否和契约定义的Body结构完全一致，比如字段数量、字段类型是否匹配

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