Django应用报错‘Cannot unpack non-iterable object’的排查求助

问题背景 #

开发音乐专辑存储的Django训练应用，尝试用自定义表单替代admin页面实现专辑添加功能。Album与Genre通过ManyToManyField关联，但访问表单页面时触发"Cannot unpack non-iterable Genre object"错误，注释genres字段后表单可正常运行。需求是表单显示所有可选流派，支持多选并关联至专辑字段。

问题原因 #

1. 表单字段类型不匹配：使用MultipleChoiceField时直接传入Genre.objects.all()，该字段要求选项为**(value, label)**二元组格式，直接传入Genre对象无法被解析，导致解包失败。
2. 多对多字段赋值逻辑错误：视图中直接用album.genres = ...赋值多对多字段，多对多关系必须在专辑实例保存后，通过add()或set()方法添加关联对象。
3. 选项初始化时机问题：CHOICES = Genre.objects.all()在模块加载时执行，无法实时同步数据库中新增的Genre数据，且可能在数据库未初始化时触发异常。

解决方案 #

1. 替换表单字段为ModelMultipleChoiceField #

Django提供ModelMultipleChoiceField专门处理模型多对多选择，自动生成符合要求的选项格式，且直接返回Genre对象，无需手动处理ID。

普通Form实现

修改forms.py：

from django import forms
from .models import Genre

class AddAlbumForm(forms.Form):
    author = forms.CharField(label="Album's author", max_length=100)
    name = forms.CharField(label="Album's name", max_length=100)
    release_date = forms.IntegerField(label="Album's release year")
    # 替换为ModelMultipleChoiceField，自动关联Genre模型
    genres = forms.ModelMultipleChoiceField(
        queryset=Genre.objects.all(),
        widget=forms.CheckboxSelectMultiple,
        label="Genres"
    )
    cover = forms.FileField()

推荐：使用ModelForm简化代码

ModelForm会自动映射模型字段，无需手动定义每个表单字段，且自动处理多对多关系：

from django import forms
from .models import Album

class AddAlbumForm(forms.ModelForm):
    class Meta:
        model = Album
        fields = ['author', 'name', 'release_date', 'genres', 'cover']
        widgets = {
            'genres': forms.CheckboxSelectMultiple,
        }
        labels = {
            'author': "Album's author",
            'name': "Album's name",
            'release_date': "Album's release year",
        }

2. 修正视图中多对多字段的赋值逻辑 #

多对多字段必须在专辑实例保存后，再添加关联的Genre对象：

普通Form对应的视图修改

修改views.py：

from django.shortcuts import render
from django.http import HttpResponseRedirect

from albums.models import Album
from albums.forms import AddAlbumForm

def add_album(request):
    if request.method == "POST":
        form = AddAlbumForm(request.POST, request.FILES)
        if form.is_valid():
            # 先保存专辑实例（此时多对多字段未关联）
            album = Album(
                name=form.cleaned_data.get("name"),
                author=form.cleaned_data.get("author"),
                release_date=form.cleaned_data.get("release_date"),
                cover=form.cleaned_data.get("cover")
            )
            album.save()
            # 添加多对多关联
            selected_genres = form.cleaned_data.get("genres")
            album.genres.set(selected_genres)  # 批量设置关联对象
            return HttpResponseRedirect("/")
    else:
        form = AddAlbumForm()
    return render(request, "albums/add_album.html", {"form": form})

ModelForm对应的视图简化

使用ModelForm时，save()方法会自动处理多对多关系，视图代码更简洁：

from django.shortcuts import render
from django.http import HttpResponseRedirect

from albums.forms import AddAlbumForm

def add_album(request):
    if request.method == "POST":
        form = AddAlbumForm(request.POST, request.FILES)
        if form.is_valid():
            form.save()  # 自动保存专辑及关联的多对多关系
            return HttpResponseRedirect("/")
    else:
        form = AddAlbumForm()
    return render(request, "albums/add_album.html", {"form": form})

3. 模板代码验证 #

原模板代码无需修改，{{ form.as_p }}会自动渲染CheckboxSelectMultiple为多选复选框，保持原有逻辑即可：

{% extends "base.html" %}

{% block page_title %}
    <h2>Add an album: </h2>
{% endblock page_title %}

{% block page_content %}
<form action="/add_album/" method="post" enctype="multipart/form-data">
    {% csrf_token %}
    {{ form.as_p }}
    <p><input type="submit" value="Submit"></p>
</form>
{% endblock page_content %}

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