Django中Many-to-Many关系查询返回None、表单初始值无法生效问题

问题根因 #

• 获取不到选中分类：filter_instance.categories_selected是多对多关系的管理器对象，并非实际的关联数据查询集，需要调用.all()方法才能获取到已选中的分类；同时如果用户从未创建过筛选规则，直接调用get()会抛出实例不存在异常，导致逻辑中断无法拿到值。
• 初始值不生效：表单中定义的多选项字段名为choices，但你在initial参数中使用的键是selection，字段名不匹配，Django无法将数据绑定到对应字段。

解决方案 #

1. 修正视图逻辑 #

@require_GET
def get_category_filter(request):
    # get_or_create 自动为新用户创建空的筛选实例，避免抛出不存在异常
    filter_instance, created = UserCategoryFilter.objects.get_or_create(user=request.user)
    # 调用.all()获取已选分类查询集
    selection = filter_instance.categories_selected.all()
    # initial参数的键改为和表单字段一致的choices
    category_filter_form = SelectCategoryForm(initial={
        'choices': selection,
    })
    context = {
        'category_filter_form': category_filter_form
    }
    template = render_to_string('core/filter_form.html', context=context)
    return JsonResponse({"form": template})

2. 可选优化（字段命名更易维护） #

如果觉得choices字段名语义模糊，可以修改表单字段命名为更贴合业务的名称，后续维护更清晰：

class SelectCategoryForm(forms.Form):
    """
    供登录用户更新分类筛选条件的表单
    """
    categories_selected = forms.ModelMultipleChoiceField(
        queryset=Category.objects.all().order_by('category'),
        widget=forms.CheckboxSelectMultiple,
        label="选择分类"
    )

对应视图的initial参数同步修改即可：

category_filter_form = SelectCategoryForm(initial={
    'categories_selected': selection,
})

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