Graphene-Django：如何在中间件追加错误而不阻断字段解析流程

核心思路 #

Graphene 完全兼容 GraphQL 规范中「响应独立包含 data 业务字段、errors 错误提示数组」的设计，不需要通过抛出异常中断整个字段解析流程，就能将自定义的认证校验提示追加到响应中，同时保留所有可正常执行的业务返回内容。
之前直接抛出 GraphQLError 导致整请求返回 data: null 的本质原因是：未被捕获的执行层异常会冒泡到整个请求的最外层执行器，触发整请求失败逻辑，而非将错误关联到单个字段、追加到全局错误列表中。

改造后的中间件实现 #

我们只需要在中间件命中触发条件时，将自定义错误信息暂存到请求上下文的专属缓存中，不中断后续的字段解析调用：

def graphql_auth_check(next, root, info, **args):
    auth_header = info.context.request.headers.get('Authorization')
    # 命中「携带认证头但令牌无效」的触发条件时，只暂存错误，不抛异常中断流程
    if auth_header and not info.context.user.is_authenticated:
        # 初始化上下文的自定义错误缓存，避免重复初始化
        if not hasattr(info.context, "custom_errors"):
            info.context.custom_errors = []
        # 按照GraphQL错误格式暂存提示信息，给客户端明确的登出触发标识
        info.context.custom_errors.append({
            "message": "客户端携带的认证令牌无效，需要重新登录",
            "extensions": {
                "code": "AUTH_TOKEN_INVALID",
                "need_logout": True
            }
        })
    # 无论是否命中校验逻辑，都正常透传后续的字段解析流程
    return next(root, info, **args)

响应层错误合并逻辑 #

仅在上下文中暂存错误不会自动生成响应，需要在Graphene返回最终响应的环节，把缓存的自定义错误合并到标准响应的 errors 数组中：
以Graphene-Django的常规集成场景为例，可以在GraphQL视图的响应拦截环节加入合并逻辑：

from graphql import GraphQLError

def merge_custom_errors_to_response(response, context):
    if hasattr(context, "custom_errors") and context.custom_errors:
        # 初始化errors字段，兼容请求本身无错误的场景
        if response.errors is None:
            response.errors = []
        # 将暂存的自定义错误转换为Graphene可序列化的标准GraphQLError格式
        for err_item in context.custom_errors:
            response.errors.append(GraphQLError(
                message=err_item["message"],
                extensions=err_item["extensions"]
            ))
    return response

实现效果 #

• 完全不阻断业务解析流程：所有匿名可访问的字段、允许公开访问的查询逻辑都会正常执行，返回对应的data内容，不会出现整请求失败的情况
• 客户端可以通过errors数组中标记的need_logout: True字段，精准识别到「携带无效认证令牌」的场景，顺畅触发用户登出逻辑，不会和其他业务运行时错误混淆
• 上下文缓存的错误信息和单次请求生命周期绑定，不会出现多请求并发下的错误串扰问题，符合Graphene的执行机制

注意：部分老旧版本的Graphene对上下文自定义属性的透传存在限制，遇到属性丢失的情况可以通过在请求初始化环节提前在context上挂载custom_errors空列表的方式解决。

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