求助：使用SerializerMutation创建数据成功但GraphiQL返回错误

我来帮你梳理这个问题——数据能成功写入数据库但GraphiQL返回错误，结合你用的graphene 2.1和graphene-django 2.0.0版本，大概率是序列化器配置不完整或Mutation返回格式不符合GraphQL预期导致的，咱们一步步来排查：

首先补全关键代码（你提供的片段有缺失） #

你给出的Serializer类Meta部分没写完，这是常见的坑，先把完整的Serializer和Mutation代码补全：

1. 完整的Serializer定义 #

from rest_framework import serializers
from .models import CompanyRole

class CompanyRoleSerializer(serializers.ModelSerializer):
    class Meta:
        model = CompanyRole  # 这里你大概率漏掉了这行！必须关联对应模型
        fields = ('id', 'name')  # 明确指定要序列化的字段，或者用'__all__'

2. 正确的SerializerMutation配置 #

graphene-django 2.0.0的SerializerMutation需要严格遵循返回格式，必须包含errors字段，同时要关联对应的GraphQL类型：

import graphene
from graphene_django.rest_framework.mutation import SerializerMutation
from graphene_django.types import DjangoObjectType
from .serializers import CompanyRoleSerializer
from .models import CompanyRole

# 先定义模型对应的GraphQL类型
class CompanyRoleType(DjangoObjectType):
    class Meta:
        model = CompanyRole

# 定义Mutation类
class CreateCompanyRoleMutation(SerializerMutation):
    class Meta:
        serializer_class = CompanyRoleSerializer

    # 自定义返回的模型字段（可选，但能让返回结构更清晰）
    company_role = graphene.Field(CompanyRoleType)

    @classmethod
    def perform_mutate(cls, serializer, info):
        # 保存数据（这一步你已经成功了）
        instance = serializer.save()
        # 必须返回包含errors和自定义字段的对象，否则GraphQL会找不到字段报错
        return cls(
            company_role=instance,
            errors=serializer.errors
        )

常见错误排查点 #

1. Serializer的Meta类必须指定model：你提供的代码片段里Meta的model属性缺失，这会导致Serializer无法正确序列化返回的实例，哪怕数据存进了数据库，返回时也会因为序列化失败抛出错误。
2. Mutation必须返回errors字段：graphene-django 2.0.0的SerializerMutation默认要求返回errors字段，哪怕没有错误也要返回空列表，否则GraphQL查询时会提示字段缺失。
3. GraphiQL查询要指定完整的返回字段：执行mutation时要明确请求所有返回字段，比如：

mutation {
  createCompanyRole(input: {name: "Admin"}) {
    companyRole {
      id
      name
    }
    errors {
      field
      messages
    }
  }
}

如果漏了errors字段，也会触发GraphQL的字段缺失错误。

调试技巧 #

打开Django的DEBUG模式（settings.py中DEBUG=True），这样GraphiQL会返回详细的错误堆栈信息，比如是哪个字段序列化失败、哪个属性缺失，能快速定位问题。

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