Django Graphene突变未处理异常：无提示仅返回Null响应

问题现象 #

• 关联Django的GraphQL系统正常执行时功能正常，但突变中的异常完全丢失：
  • 无错误场景下响应符合预期；
  • 若突变执行时抛出异常（哪怕是第一行），应用日志无任何记录，GraphQL仅返回含Null的JSON：

    {
        "data": {
            "exampleMutation": {
                "mutationResponseSchema": null
            }
        }
    }
    

  • 就算用try-except包裹Django相关代码（比如获取FilterSet），只要有异常抛出（哪怕已捕获），依然会触发空响应，异常去向不明，系统仿佛直接忽略了异常。

环境差异 #

另有一个结构完全一致的旧应用，基于Python 3.8（当前应用用Python 3.11，Django、Graphene及相关依赖均已升级），旧应用能正常处理异常：抛出异常时，端点会返回明确的错误信息。怀疑Graphene的错误处理逻辑有变更，但没找到官方明确说明。

示例代码 #

突变实现 #

class ExampleMutation(graphene.Mutation):
    class Arguments:
       fail_here = graphene.String()

    some_schema = graphene.Field(SomeSchema)

    @authorized
    def mutate(root, info, user, **kwargs):
        # 直接在此处抛出Exception('automatic exception')结果完全一致
        if kwargs.get('fail_here') == 'yes':
            raise Exception('text')  # 异常类型不影响最终结果
        else:
            django_model = SomeSchemaModel.objects.first()
            return ExampleMutation(some_schema=django_model)       

正常请求示例 #

传入变量{"failHere": "No"}调用以下突变，响应有效且符合预期，说明GraphQL与Django的基础结构没问题：

mutation exampleMutation($failHere: String){
    exampleMutation(
        failHere: $failHere,
    ) {
        someSchema
        {
            field1
            field2
        }
    }
}

异常场景响应 #

传入变量{"failHere": "yes"}调用端点（或直接在突变第一行抛错）时，返回如下空响应：

{
    "data": {
        "exampleMutation": {
            "someSchema": null
        }
    }
}

排查建议 #

1. 核对Graphene版本变更：对比新旧应用的graphene-django版本，重点查看错误处理相关的更新日志。新版本可能默认屏蔽了异常，或者需要手动配置捕获逻辑。
2. 检查@authorized装饰器：这个装饰器可能内部吞掉了异常并返回空结果，而非重新抛出。查看装饰器代码里是否有try-except块静默处理了异常。
3. 排查Django中间件：检查当前应用的中间件列表，是否有新增的中间件在捕获GraphQL异常并修改响应内容。
4. 配置GraphQL异常处理器：在settings.py的GRAPHENE配置项中，检查是否设置了EXCEPTION_HANDLER。新版本可能需要自定义处理器才能返回错误信息，示例自定义处理器：

   def custom_exception_handler(exc, context):
       # 先调用默认处理器获取基础响应
       response = graphene_django.views.exception_handler(exc, context)
       if response is None:
           # 处理默认未捕获的异常
           return {
               "errors": [{"message": str(exc)}],
               "data": None
           }
       return response
   

   然后在settings中配置：

   GRAPHENE = {
       'SCHEMA': 'your_project.schema.schema',
       'EXCEPTION_HANDLER': 'your_project.utils.custom_exception_handler'
   }
   

5. 验证Python版本异常差异：Python 3.11新增了ExceptionGroup等异常特性，确认代码中是否存在因版本特性导致的异常静默处理情况。

内容的提问来源于stack exchange，提问作者J.T.