如何将带命名操作的DocumentNode列表合并为单个GraphQL DocumentNode

问题分析 #

你遇到的GraphQLError: This anonymous operation must be the only defined operation错误，根源是concat_ast会直接将多个DocumentNode的顶级定义拼接在一起，导致生成的文档包含多个独立的操作块（比如多个query { ... }）。当存在匿名操作时，GraphQL要求文档中只能有一个匿名操作，因此触发报错。

最优解决方案：手动合并AST的选择集 #

不需要先合并字典再生成DocumentNode，可以直接操作AST结构，提取每个DocumentNode中的查询字段，合并到同一个操作里。这样既保留了原DocumentNode用于单独查询各表的能力，又能生成合法的合并查询。

代码实现（Python） #

假设你使用的是graphql-core库，以下是合并函数的示例：

from graphql import DocumentNode, OperationDefinitionNode, SelectionSetNode

def merge_query_documents(documents: list[DocumentNode]) -> DocumentNode:
    all_selections = []
    
    # 遍历每个输入文档，提取所有查询操作的字段
    for doc in documents:
        for definition in doc.definitions:
            if isinstance(definition, OperationDefinitionNode) and definition.operation == "query":
                # 把当前查询的所有选择字段加入集合
                all_selections.extend(definition.selection_set.selections)
    
    # 创建合并后的查询操作
    merged_operation = OperationDefinitionNode(
        operation="query",
        selection_set=SelectionSetNode(selections=all_selections)
    )
    
    # 返回合并后的DocumentNode
    return DocumentNode(definitions=[merged_operation])

使用方式 #

• 保留原来的每个DocumentNode，用于单独查询对应的数据表。
• 需要批量查询时，调用merge_query_documents传入所有需要合并的DocumentNode，得到合法的合并查询文档。

为什么这个方案更好 #

1. 无需额外维护查询字典，直接复用已有的DocumentNode，减少代码冗余。
2. 生成的合并文档符合GraphQL规范，不会出现多操作块的语法错误。
3. 灵活控制合并的范围，可按需选择需要合并的查询。

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