Django GraphQL含外键的图书数据创建失败问题排查

现象 #

创建作者的Mutation可正常执行，但创建图书的Mutation返回book: null，且dim_all_books表无新增记录，无论传入的authorName是否存在。

核心原因 #

1. 外键字段赋值错误：Book模型的author_name是ForeignKey字段，要求传入Author模型的实例（或主键值），但当前代码直接传入字符串，导致Django无法识别，保存操作失败。
2. 缺少异常处理：CreateBook的mutate方法未捕获保存时的异常，错误发生后直接返回null，无法定位问题根源。
3. Author模型方法错误：Author的__str__方法返回self.name，但模型中无name字段，会导致潜在报错（非直接原因，但需修复）。

解决方案 #

1. 修复Book Mutation的外键处理逻辑 #

修改books/schema.py中的CreateBook类，先查询对应Author实例，再关联到Book对象：

# 先导入Author模型
from authors.models import Author

class CreateBook(graphene.Mutation):
    class Arguments:
        book_data = BookInputType(required=True)

    book = graphene.Field(BookType)
    # 新增错误字段用于返回错误信息
    error = graphene.String()

    @staticmethod
    def mutate(root, info, book_data=None):
        try:
            # 根据传入的author_name查询Author实例
            author = Author.objects.get(author_name=book_data.author_name)
            book_instance = Book(
                title=book_data.title,
                subtitle=book_data.subtitle,
                # 关联Author实例，而非字符串
                author_name=author,
                year_published=book_data.year_published,
                review=book_data.review
            )
            book_instance.save()
            return CreateBook(book=book_instance, error=None)
        except Author.DoesNotExist:
            return CreateBook(book=None, error=f"作者 {book_data.author_name} 不存在")
        except Exception as e:
            return CreateBook(book=None, error=str(e))

2. 修复Author模型的__str__方法 #

修改authors/models.py：

def __str__(self):
    return self.author_name  # 替换原有的self.name

3. （可选）优化字段命名规范 #

为匹配GraphQL的驼峰命名习惯，修改BookInputType的字段名，并同步mutate方法中的调用：

class BookInputType(graphene.InputObjectType):
    title = graphene.String()
    subtitle = graphene.String()
    authorName = graphene.String()  # 修改为驼峰命名
    yearPublished = graphene.String()  # 可选：同步其他字段命名
    review = graphene.Float()

同时在mutate方法中将book_data.author_name改为book_data.authorName。

验证修改后的Mutation #

执行创建图书的Mutation：

mutation CreateNewBook {
  createBook(bookData: {
    title: "Romeo & Juliet",
    subtitle: "",
    authorName: "William Shakespeare",
    yearPublished: "1736",
    review: 3.2
  }) {
    book {
      title
    }
    error
  }
}

若作者存在，会返回图书标题；若不存在，会返回对应的错误提示。

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