如何为使用持久化查询的GraphQL端点编写高效可维护的负载测试

核心思路就是别硬编码哈希值——每次应用更新都改测试脚本太折腾，不如从应用的静态资源或内部接口动态拉取最新的查询哈希映射，或者直接用和应用一致的算法生成哈希。

1. 从应用的静态manifest文件拿哈希映射 #

很多用持久化查询的GraphQL应用会生成一个persisted-queries.json这类的清单文件，里面存着查询名称到哈希的对应关系。k6可以在测试启动前就加载这个文件：

import http from 'k6/http';
import { sleep } from 'k6';

// 测试初始化时拉取最新的查询哈希映射
const queryHashes = http.get('https://你的应用域名/persisted-queries.json').json();

// 这里列你要测的查询名称——这些是业务相关的，不会随应用更新随便改
const targetQueries = ['getUserProfile', 'fetchProductList', 'submitOrder'];

export default function () {
  targetQueries.forEach(queryName => {
    const hash = queryHashes[queryName];
    if (!hash) {
      console.error(`找不到查询${queryName}的哈希值`);
      return;
    }

    // 发送持久化查询请求
    const res = http.post('https://你的应用域名/graphql', JSON.stringify({
      id: hash,
      variables: { userId: '123', productCategory: 'electronics' } // 变量可以根据测试场景动态生成
    }), {
      headers: { 'Content-Type': 'application/json' },
    });

    // 简单断言响应是否正常
    if (res.status !== 200) {
      console.error(`查询${queryName}失败，状态码：${res.status}`);
    }
    sleep(1);
  });
}

2. 从内部API端点获取哈希映射 #

如果没有公开的manifest文件，找开发团队加个内部接口（比如/api/persisted-queries）返回当前的查询哈希表就行。测试脚本的逻辑和上面一样，初始化时拉取这个接口的数据即可。

3. 自己算哈希（如果算法统一） #

要是应用用的是标准哈希算法（比如SHA-256），直接在测试脚本里用原始查询字符串生成哈希就行，不用依赖外部资源：

import crypto from 'k6/crypto';
import http from 'k6/http';
import { sleep } from 'k6';

// 这里存原始查询字符串——这些是业务逻辑核心，不会随便改
const rawQueries = {
  getUserProfile: `query GetUserProfile($userId: ID!) {
    user(id: $userId) { name email }
  }`,
  fetchProductList: `query FetchProductList($category: String!) {
    products(category: $category) { id name price }
  }`
};

// 用和应用一致的算法生成哈希
function getQueryHash(query) {
  return crypto.sha256(query, 'hex');
}

export default function () {
  Object.entries(rawQueries).forEach(([queryName, query]) => {
    const hash = getQueryHash(query);
    const res = http.post('https://你的应用域名/graphql', JSON.stringify({
      id: hash,
      variables: { userId: '123', category: 'electronics' }
    }), {
      headers: { 'Content-Type': 'application/json' },
    });

    if (res.status !== 200) {
      console.error(`查询${queryName}执行失败`);
    }
    sleep(1);
  });
}

让测试更易维护的小技巧 #

• 把查询和变量拆到单独文件：比如建个queries.js存所有原始查询，test-data.js存测试用的变量，测试脚本只负责逻辑，改需求时不用动核心代码。
• 参数化测试数据：用k6的SharedArray或者CSV文件加载不同的用户ID、商品分类等数据，避免硬写死测试用例。
• 封装断言函数：把检查响应状态、GraphQL错误这些逻辑写成通用函数，每个查询都复用，减少重复代码。

其他适配工具推荐 #

如果k6不太合你意，还可以试试：

• Artillery：原生支持GraphQL，能通过配置或脚本动态获取哈希，模板系统做参数化测试很方便。
• Gatling：适合复杂负载场景的性能测试工具，能自定义代码逻辑拉取查询哈希映射，灵活性很高。

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