如何在GraphQL中批量执行多变量组合的查询请求？

现有场景与定义 #

当前我有一个支持单组变量的GraphQL查询，可正常运行，相关定义如下：

type Record {
    asset(count: String!, lang: String!): Cat!
}

query ($count: String!, $lang: String!) {
    asset(count: $count, lang: $lang) {
        vid {
            orig
        }
    }
}

对应的单组变量示例：

{
    "count":"abc", 
    "lang":"def"
}

需求说明 #

我需要执行多组count与lang的配对查询，比如同时获取以下两组组合的结果：

• count="abc"、lang="a"
• count="def"、lang="b"

曾尝试将查询变量改为数组类型query ($count: [String!], $lang: [String!])，但无法生效。已知可以用别名实现，但查询内容庞大且组合数超过10组，希望找到更高效的实现方式。

可行解决方案 #

1. 服务端扩展批量查询字段（最优方案） #

如果有权限修改GraphQL服务端的Schema，直接新增一个支持批量参数的字段是最简洁高效的方式：

type Record {
    asset(count: String!, lang: String!): Cat!
    # 新增批量查询字段
    assetsBatch(params: [AssetParam!]!): [Cat!]!
}

# 定义批量参数的输入类型
input AssetParam {
    count: String!
    lang: String!
}

之后就可以通过一次查询获取所有组合的结果：

query ($batchParams: [AssetParam!]!) {
    assetsBatch(params: $batchParams) {
        vid {
            orig
        }
    }
}

对应的批量变量：

{
    "batchParams": [
        {"count":"abc", "lang":"a"},
        {"count":"def", "lang":"b"}
        // 可继续添加更多组合
    ]
}

2. 客户端动态生成带别名的查询（无服务端修改权限时） #

如果无法修改服务端，只能通过客户端动态生成带唯一别名的查询来实现。针对N组参数，生成N个带不同别名的asset查询：

示例查询（两组参数）：

query ($count1: String!, $lang1: String!, $count2: String!, $lang2: String!) {
    asset1: asset(count: $count1, lang: $lang1) {
        vid {
            orig
        }
    }
    asset2: asset(count: $count2, lang: $lang2) {
        vid {
            orig
        }
    }
    # 继续添加更多带别名的asset查询
}

对应的变量：

{
    "count1":"abc", "lang1":"a",
    "count2":"def", "lang2":"b"
    # 对应添加更多变量
}

可以通过代码自动生成查询字符串和变量对象，避免手动编写重复内容，以JavaScript为例：

// 定义所有需要查询的参数组合
const params = [
  { count: "abc", lang: "a" },
  { count: "def", lang: "b" }
];

// 生成查询的字段部分
const queryFields = params.map((_, index) => {
  const alias = `asset${index + 1}`;
  const countVar = `$count${index + 1}`;
  const langVar = `$lang${index + 1}`;
  return `${alias}: asset(count: ${countVar}, lang: ${langVar}) { vid { orig } }`;
}).join(" ");

// 生成变量定义部分
const varDefinitions = params.map((_, index) => {
  return `$count${index + 1}: String!, $lang${index + 1}: String!`;
}).join(", ");

// 拼接完整查询
const finalQuery = `query (${varDefinitions}) { ${queryFields} }`;

// 生成变量对象
const finalVariables = params.reduce((acc, param, index) => {
  acc[`count${index + 1}`] = param.count;
  acc[`lang${index + 1}`] = param.lang;
  return acc;
}, {});

注意事项 #

• 动态生成别名时，需保证别名唯一，避免冲突
• 部分GraphQL服务存在查询复杂度或字段数量限制，大量别名查询可能触发限制，此时优先选择服务端扩展方案

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