Django GraphQL报Invalid introspection result错误修复方法

GraphiQL抛出的内省错误本质是后端GraphQL Schema构建失败或接口执行报错，返回的响应中没有合法的data字段，前端拿不到内省结果就会触发该提示。你的代码存在几个核心问题：

• 主Schema初始化时没有挂载根Query、Mutation类型，Schema本身无效
• Mutation逻辑存在多处漏洞，执行时会触发数据库非空约束、字段缺失等报错
• 自定义用户模型配置不完整，和Django认证系统的要求不匹配

1. 修正主Schema配置 #

这是触发本次报错的核心原因：你在主schema文件中初始化graphene.Schema()时没有传入定义好的Query和Mutation根类型，graphene无法识别任何可用的GraphQL接口，直接导致Schema构建失败。
将主schema文件最后一行替换为如下代码：

schema = graphene.Schema(query=Query, mutation=Mutation)

完整主schema代码：

import graphene
import accounts.schema

class Query(graphene.ObjectType):
    # 后续新增查询字段可在此处定义，空类不影响Schema运行
    pass

class Mutation(accounts.schema.Mutation, graphene.ObjectType):
    pass

schema = graphene.Schema(query=Query, mutation=Mutation)

2. 修正CreateUser Mutation逻辑 #

现有Mutation代码存在三个问题：

• 先创建用户实例再做密码校验，逻辑顺序不合理
• 创建用户时未传入username字段（Django AbstractUser默认要求该字段非空），保存时会触发数据库报错
• 将仅用于校验的confirm_password传入用户模型，产生冗余字段写入
  修正后的accounts/schema.py中CreateUser部分代码：

class CreateUser(graphene.Mutation):
    user = graphene.Field(CustomUserType)

    class Arguments:
        user_data = CustomUserInput(required=True)
        
    def mutate(self, info, user_data=None):
        # 优先做参数校验，不通过直接抛出异常
        if user_data.password != user_data.confirm_password:
            raise Exception("Passwords do not match!")
        # 校验通过后再创建用户实例，不传入confirm_password（无需持久化存储）
        user = CustomUser(
            email=user_data.email,
            username=user_data.email, # 若后续配置邮箱登录可直接复用该值
            full_legal_name=user_data.full_legal_name,
            title=user_data.title,
            phone_number=user_data.phone_number,
            physical_address=user_data.physical_address,
            role=user_data.role
        )
        # 对明文密码做哈希处理
        user.set_password(user_data.password)
        user.save()
        # 返回Mutation实例
        return CreateUser(user=user)

CustomUserInput中的confirm_password字段可以保留用于接口层校验，无需删除。

3. 补全CustomUser模型配置 #

现有自定义用户模型存在配置缺失：

• 未指定登录用户名字段，默认使用username但业务逻辑中未做唯一性约束
• email字段未加唯一索引，作为账号标识存在重复风险
• title字段定义了选项枚举但未绑定到模型字段，选项不生效
• 冗余存储confirm_password字段，无实际业务价值
  修正后的models.py代码：

from django.db import models
from django.contrib.auth.models import AbstractUser


class CustomUser(AbstractUser):
    TITLES = (
        ('Mr', 'Mr'),
        ('Mrs', 'Mrs')
    )

    ROLES = (
        ('school_admin', 'school_admin'),
        ('app_admin', 'app_admin'),
        ('school_staff', 'school_staff')
     )

    email = models.EmailField(blank=False, unique=True, max_length=255, verbose_name='email address')
    full_legal_name = models.CharField(max_length=255, verbose_name='full legal name')
    title = models.CharField(max_length=10, choices=TITLES, verbose_name='title')
    phone_number = models.CharField(max_length=20, verbose_name='phone number')
    physical_address = models.CharField(max_length=255, verbose_name='physical address')
    role = models.CharField(max_length=50, choices=ROLES, verbose_name='role')

    EMAIL_FIELD = "email"
    USERNAME_FIELD = "email" # 配置使用邮箱作为登录账号
    REQUIRED_FIELDS = ['full_legal_name', 'title', 'phone_number', 'physical_address', 'role'] # 创建超级管理员时的必填字段

注意：修改用户模型后需要执行python manage.py makemigrations和python manage.py migrate更新数据库结构，如果之前已经生成过迁移文件，建议清空accounts应用下migrations文件夹中除__init__.py外的文件再重新生成迁移。

后续再遇到同类内省报错，不需要猜测问题来源，直接通过浏览器开发者工具查看接口原始响应即可定位：

• 打开GraphiQL页面时按F12打开开发者工具，切换到「网络」面板
• 刷新页面，找到路径为/graphql的请求，查看「响应」面板
• 响应中errors字段会明确标注具体报错位置，可能是Schema语法错误、数据库约束报错、字段解析异常等

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