Datadog多步骤API测试中GraphQL请求变量解析失败问题排查

问题重现 #

在Datadog构建多步骤API测试时，使用带变量的GraphQL请求获取数据，变量部分始终提示验证错误。PAGESIZE是存储整数的本地变量，原始请求体写法如下：

query Organizations($pageSize: Int) {
   organizations(pageSize: $pageSize) {
    count
    items {
      id
    }
  }
}

{
  "pageSize" {{ PAGESIZE }}
}

尝试过"pageSize": {{PAGESIZE}}、"pageSize": 10等多种变量格式，均无法通过验证；移除变量部分后请求可正常返回全部结果，但需要控制仅返回10条记录。

错误原因 #

1. 请求体格式不符合GraphQL标准：你将GraphQL查询语句与变量对象直接拼接，这不是合法的GraphQL POST请求结构。标准GraphQL POST请求体必须是包含query（字符串类型的查询语句）和variables（JSON对象类型的变量集合）的JSON对象。
2. 变量嵌入后JSON不合法：即使调整了变量的写法，若整体请求结构错误，Datadog仍会判定格式无效。

解决方法 #

方法1：使用标准GraphQL JSON请求体

将请求体改为标准JSON结构，同时正确嵌入Datadog变量：

{
  "query": "query Organizations($pageSize: Int) { organizations(pageSize: $pageSize) { count items { id } } }",
  "variables": {
    "pageSize": {{ PAGESIZE }}
  }
}

注意：{{ PAGESIZE }}是整数类型变量，插值后会直接替换为数字，不需要加引号，确保生成的JSON格式合法。

方法2：利用Datadog的GraphQL拆分输入框（若支持）

部分Datadog API测试界面会将GraphQL的查询和变量分为两个独立输入框：

• 查询输入框填写完整的GraphQL语句：

query Organizations($pageSize: Int) {
   organizations(pageSize: $pageSize) {
    count
    items {
      id
    }
  }
}

• 变量输入框填写JSON格式的变量：

{
  "pageSize": {{ PAGESIZE }}
}

验证时确保JSON符号（括号、逗号）完整闭合，且PAGESIZE变量的实际值为整数类型。

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