Django Admin一对多内联选择保存报错：未保存模型实例无法用于ORM查询

嘿，我帮你排查下这个问题哈！

你遇到的这个「Unsaved model instance (Shelf: ShelfAlpha) cannot be used in an ORM query」报错，本质是Django ORM的规则限制：你正在添加的新Shelf还没保存到数据库，连主键（pk）都没有，这时候用它作为查询条件去筛选Book，ORM根本找不到对应的数据库记录，自然就报错了。

解决方案 #

假设你是通过自定义表单/ModelAdmin来实现「添加Shelf时选择已有Book」的功能，咱们只需要调整逻辑，区分「添加新Shelf」和「编辑已有Shelf」两种场景就行：

1. 修改自定义表单的查询逻辑

如果你用了自定义ModelForm，在初始化表单时，只在Shelf已经存在（有主键）的情况下，用它过滤关联的Book；添加新Shelf时，直接显示所有可用的Book：

from django import forms
from .models import Shelf, Book

class ShelfAdminForm(forms.ModelForm):
    # 自定义多选框用来选要关联的图书
    selected_books = forms.ModelMultipleChoiceField(
        queryset=Book.objects.all(),
        required=False,
        label="关联图书"
    )

    def __init__(self, *args, **kwargs):
        super().__init__(*args, **kwargs)
        # 只有编辑已有的Shelf时，才把已关联的图书设为默认选项
        if self.instance.pk:
            self.fields['selected_books'].initial = self.instance.book_set.all()

    def save(self, commit=True):
        shelf = super().save(commit=commit)
        # 重点！必须先把shelf保存到数据库（拿到主键），再去关联图书
        if commit:
            shelf.book_set.set(self.cleaned_data['selected_books'])
        return shelf

2. 更新Admin配置

把这个自定义表单绑定到Shelf的Admin配置里：

from django.contrib import admin
from .models import Shelf
from .forms import ShelfAdminForm

class ShelfAdmin(admin.ModelAdmin):
    form = ShelfAdminForm
    # 其他Admin配置（比如显示字段、搜索字段）保持不变就行

admin.site.register(Shelf, ShelfAdmin)

核心注意点 #

• 一定要先保存Shelf到数据库（拿到主键），再处理和Book的关联。如果你的旧代码是先关联Book再保存Shelf，就会触发这个错误——毕竟没主键的Shelf，数据库根本不认它。
• 添加新Shelf时，别用未保存的实例去过滤Book，直接用Book.objects.all()展示所有可选图书就好。

这样改完之后，你在添加Shelf时就能正常选已有Book，保存的时候也不会再碰到那个ORM报错啦～

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