python-gql变量使用方法、fetch_user函数问题及Python GraphQL客户端推荐

1. 在python-gql中使用变量的方法 #

在python-gql里用变量其实很直观，核心就两步走：

• 先写好带变量占位符的GraphQL查询（用$变量名: 类型的格式声明变量）
• 调用client.execute()时，通过variable_values参数把实际值传进去

给你个完整的示例参考：

from gql import Client, gql
from gql.transport.requests import RequestsHTTPTransport

# 先初始化客户端
transport = RequestsHTTPTransport(url="你的GraphQL接口地址")
client = Client(transport=transport, fetch_schema_from_transport=True)

# 定义带变量的查询语句
query = gql("""
    query GetUser($username: String!) {
        user(where: {name: {_eq: $username}}) {
            id
            name
        }
    }
""")

# 传入变量执行查询
result = client.execute(query, variable_values={"username": "Alice"})
print(result["user"])

小贴士：变量类型后面加!表示这是个非空变量，如果你确定用户名不会为空，加上它能让查询更严谨，避免后端返回不必要的错误。

2. 修正fetch_user函数 & 推荐更优Python GraphQL客户端 #

函数修正的问题分析 #

你的代码返回所有用户，核心原因是没把username变量传递给execute方法——查询里的$username没有被赋值，后端可能默认匹配了所有用户（比如_eq遇到空值时返回全部）。

修正后的代码如下：

def fetch_user(username):
    query = gql("""
        query getUser($username: String!) {
            user( where: { name: { _eq: $username } } ) {
                id
                name
            }
        }
    """)
    # 关键：添加variable_values参数传递变量
    result = client.execute(query, variable_values={"username": username})
    # 根据后端返回结构，直接返回用户数据（可能是单个对象或列表，按需调整）
    return result.get("user")

另外建议给变量类型加上!，避免传入空值时出现意外结果。

更优Python GraphQL客户端推荐 #

如果觉得gql太简洁、文档不够用，可以试试这些替代方案：

• gql v3+版本：其实新版gql已经完善了文档，支持异步/同步两种模式，还集成了AIOHTTP等传输层，功能比旧版丰富很多，优先推荐升级到最新版。
• 直接用requests构造请求：如果不需要客户端封装的额外功能，直接用requests发POST请求，手动构造GraphQL请求体，灵活性拉满：

  import requests
  
  def fetch_user(username):
      url = "你的GraphQL接口地址"
      payload = {
          "query": """
              query getUser($username: String!) {
                  user(where: {name: {_eq: $username}}) {
                      id
                      name
                  }
              }
          """,
          "variables": {"username": username}
      }
      response = requests.post(url, json=payload)
      return response.json().get("data", {}).get("user")
  

• Strawberry Client：Strawberry是个类型安全的GraphQL框架，它的客户端支持Python类型注解，能自动生成查询，适合喜欢强类型的开发者。
• Ariadne Client：虽然Ariadne主打服务器端，但它也提供了简单的客户端工具，适合和Ariadne服务器配合使用。

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