Graphene-Flask已归档停更，官方推荐改用graphql-server-core+flask手搭或更稳妥的ariadne；其最新版仅兼容旧版Flask，不适用于当前主流环境。
Flask里加GraphQL，Graphene-Flask已不维护，别踩坑
Graphene-Flask 早在 2021 年就停止维护，最新版只兼容 Flask AttributeError: 'Flask' object has no attribute 'add_url_rule' 或 graphql.execution.executors.asyncio.AsyncioExecutor 找不到——因为底层执行器接口全变了。
正确路径是：弃用 graphene-flask，改用官方推荐的 graphql-server-core + flask-graphql（仅作 HTTP 层封装），Schema 层仍用 graphene（v3.x）或更现代的 strawberry。本文以 graphene v3.2 为主，因迁移成本低、文档延续性强。
用 flask-graphql 挂载 Graphene v3 Schema，三步到位
flask-graphql 是轻量胶水层，只负责解析 POST/GET 请求、转发到 GraphQL 执行器、返回 JSON 响应，不碰 Schema 定义。关键在于初始化时传入正确的 schema 实例和执行配置。
- 安装：
pip install flask-graphql graphene（graphenev3.2+，非graphene-core） - 定义 Schema 必须是
graphene.Schema实例，且query参数要传ObjectType子类，不能传模块或字符串 - 挂载路由时禁用 GraphiQL 在生产环境自动开启（通过
graphiql=False），否则会暴露调试界面
示例代码：
安全 Python 代码沙箱：在隔离的沙箱中执行任意 Python 代码，预装 requests、NumPy、pandas 库。返回 stdout、stderr。
立即学习“Python免费学习笔记（深入）”；
from flask import Flask
from flask_graphql import GraphQLView
import graphene
class Query(graphene.ObjectType):
hello = graphene.String(name=graphene.String(default_value="World"))
def resolve_hello(self, info, name):
return f"Hello {name}"
schema = graphene.Schema(query=Query)
app = Flask(__name__)
app.add_url_rule(
'/graphql',
view_func=GraphQLView.as_view('graphql', schema=schema, graphiql=True)
)
字段 resolver 返回值类型必须与声明严格一致
Graphene v3 默认启用严格类型检查。如果 resolve_xxx 返回 None，但字段声明为 graphene.String（非 graphene.String(required=False)），就会抛 GraphQLError: Cannot return null for non-nullable field。
- 数据库查不到数据时，别直接 return None；改用
graphene.String(required=False)+ 显式 return None，或提前 raisegraphene.GraphQLError("Not found") - 列表字段如
graphene.List(graphene.String)，resolver 必须返回 list/tuple，不能返回 generator（会触发TypeError: object of type 'generator' is not subscriptable） - 日期字段建议用
graphene.DateTime，别用graphene.String转 ISO 格式——前者自动处理时区和序列化，后者容易在客户端解析失败
并发请求下，避免在 resolver 里共享 mutable 状态
Flask 默认用多线程（或 Werkzeug 开发服务器的多线程模式），所有请求共用同一个 Schema 实例。如果在 resolve_xxx 中修改了类属性、模块变量或全局 dict，会导致不同用户的查询结果互相污染。
- 错误写法：
self.cache = {}写在 resolver 内部（self是 Schema 实例，跨请求复用） - 安全做法：用
info.context传 request-scoped 数据，例如info.context.get("db_session")；或用threading.local()绑定当前线程 - 第三方库如 SQLAlchemy 的 session，务必每个 resolver 单独
sessionmaker()创建新 session，别复用 module-level session 对象
复杂点往往不在 Schema 写法，而在 resolver 里混用了同步阻塞调用（比如 requests.get）又没设 timeout，导致整个 Flask worker 被卡住。真要调外部 API，优先上 httpx.AsyncClient + async def resolve_xxx，并确保 Flask 启动时用 app.run(..., threaded=False, use_reloader=False) 配合异步支持。
