Django ModelForm保存布尔字段时报错：'bool' object is not iterable

1. 定位报错核心代码行 #

从报错栈里找到触发'bool' object is not iterable的具体代码位置，常见触发场景包括：

• 对布尔值（True/False）执行了迭代操作（比如for val in is_active）
• 使用了需要可迭代对象的运算符，比如if 'xxx' in is_active
• 在表单的clean_xxx方法或视图逻辑中，错误地把布尔字段值当成列表/字符串这类可迭代类型处理

2. 检查ModelForm的字段处理逻辑 #

• 确认ModelForm中没有错误覆盖BooleanField类型，比如误将forms.BooleanField写成forms.MultipleChoiceField这类需要可迭代值的字段
• 排查表单的clean或clean_xxx方法，避免对布尔值执行可迭代操作。示例：

  # 错误写法（会触发报错）：
  def clean_is_active(self):
      is_active = self.cleaned_data.get('is_active')
      if 'true' in is_active:  # is_active是布尔值，无法执行in操作
          return True
      return False
  
  # 正确写法：
  def clean_is_active(self):
      return self.cleaned_data.get('is_active', False)
  

3. 检查视图中的表单处理逻辑 #

确认视图里没有在手动修改布尔字段值时引入迭代操作，比如：

# 错误示例：
form = UserProfileForm(request.POST)
if form.is_valid():
    instance = form.save(commit=False)
    # 错误地尝试遍历布尔值
    for flag in instance.is_active:
        pass
    instance.save()

4. 关于PostgreSQL布尔值存储的补充说明 #

Django的BooleanField会自动适配PostgreSQL的boolean类型，无需额外处理。如果数据库中布尔值是以字符串（比如't'/'f'或'true'/'false'）存储的：

• 优先建议将数据库字段改为boolean类型，匹配Django的字段定义
• 若无法修改数据库，可在ModelForm的clean_xxx方法中手动转换字符串为布尔值：

  def clean_is_active(self):
      data = self.cleaned_data.get('is_active')
      if isinstance(data, str):
          return data.lower() == 'true'
      return bool(data)
  

5. 验证前端传递的表单数据 #

打印request.POST中的布尔字段值，确认前端传递的是合法值（比如'on'/'off'或True/False），若前端传递格式异常，可在clean方法中做兼容转换。

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