过滤Boolean字段报错too many values to unpack (expected 2)的原因与解决

错误根源 #

你代码里的问题很明确：在products_promoted = Product.objects.filter('promote=True')[:7]这一行，你把查询条件写成了字符串，但Django的filter()方法不接受这种形式。

filter()方法需要的是关键字参数（比如promote=True）或者查询表达式，当你传入字符串'promote=True'时，Django会尝试把这个字符串当作可迭代的位置参数来解析——它期望得到的是(字段名, 值)这样的二元组，但字符串会被拆成单个字符的序列，自然就会抛出"too many values to unpack"的错误，因为字符数量远不止2个。

修复方案 #

只需要把字符串形式的条件改成Django能识别的格式就行，这里给你几种常用的正确写法：

1. 直接使用关键字参数（最简洁推荐） #

这是最常用的写法，直接把字段名和值作为关键字参数传入：

products_promoted = Product.objects.filter(promote=True)[:7]

2. 字典解包（适合动态条件场景） #

如果你的查询条件是动态生成的（比如从前端参数获取），可以把条件放在字典里，用**解包传递：

# 比如动态生成的条件
filter_params = {'promote': True}
products_promoted = Product.objects.filter(**filter_params)[:7]

3. Q对象（适合复杂逻辑查询） #

如果之后需要组合多个查询条件（比如AND/OR逻辑），可以使用Q对象来构建：

from django.db.models import Q

products_promoted = Product.objects.filter(Q(promote=True))[:7]

额外小提示：如果要查询promote为False的记录，直接写filter(promote=False)就可以，写法和查询True完全一致。

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