Django执行makemigrations触发ValueError，求助排查购物车模型问题

这个错误本质是Django解析模型定义时，遇到了格式不符合预期的可迭代对象，解包时拿到的元素数量超出预期。结合购物车模型（Carrinho）的场景，常见错误点及修复方法如下：

1. 字段 choices 参数格式错误 #

choices 要求是二元组组成的可迭代对象，每个元组必须是 (存储值, 显示文本) 的结构。如果某个字段的 choices 写了三元组或更多元素，就会触发该错误。

错误示例：

class Carrinho(models.Model):
    status = models.CharField(
        max_length=20,
        choices=(('ativo', 'Ativo', '额外冗余参数'), ('finalizado', 'Finalizado'))
    )

修复：移除多余元素，保证每个选项都是二元组：

status = models.CharField(
    max_length=20,
    choices=(('ativo', 'Ativo'), ('finalizado', 'Finalizado'))
)

2. 关联字段（ForeignKey/ManyToManyField）参数传递错误 #

ForeignKey 仅接受两个必填位置参数：关联模型、on_delete。如果误传多个位置参数，会导致Django解析时解包出错。

错误示例：

class Carrinho(models.Model):
    usuario = models.ForeignKey(User, Perfil, on_delete=models.CASCADE)

修复：仅传递关联模型和 on_delete，其他参数用关键字传递：

usuario = models.ForeignKey(User, on_delete=models.CASCADE, related_name='carrinhos')

3. Meta类中 unique_together/index_together 格式错误 #

这两个选项要求是包含多元组的可迭代对象，如果直接传单个字段的元组，会被Django当成多个独立约束，触发解包错误。

错误示例：

class Carrinho(models.Model):
    # ... 其他字段
    class Meta:
        unique_together = ('usuario', 'produto')  # 错误：缺少外层嵌套

修复：外层嵌套一层元组或列表：

class Meta:
    unique_together = (('usuario', 'produto'),)

（注：Django 2.2+ 推荐用 constraints 替代 unique_together，写法更清晰）

4. 结合报错堆栈精准定位 #

查看报错堆栈的最后几行，能直接锁定错误来源：

• 若堆栈指向 django/db/models/fields/__init__.py 中处理 choices 的代码，优先检查字段的 choices 参数；
• 若指向关联字段的初始化逻辑，检查 ForeignKey/ManyToManyField 的参数传递；
• 若指向 Meta 类的处理代码，检查 unique_together 等元选项格式。

比如典型报错片段：

File "/venv/lib/python3.9/site-packages/django/db/models/fields/__init__.py", line 841, in choices
    for option_key, option_value in choices:
ValueError: too many values to unpack (expected 2)

这就明确是 choices 参数的格式问题。

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