Django TypeError：字段'roof_age'预期数字却获元组，如何解决？

问题说明 #

提交表单时触发TypeError at /form，错误提示：

Field 'roof_age' expected a number but got ('1',).

打印POST参数后发现，所有获取到的参数值都是元组类型。

问题根源 #

• 模型Details中roof_age是IntegerField，要求传入数值类型
• 视图代码中，每个POST参数赋值语句末尾都加了逗号（比如name=requests.POST['name'],），在Python中，单个值加逗号会被解析为元组，导致传入模型时类型不匹配

解决方法 #

1. 移除赋值语句末尾的逗号 #

直接删掉每个变量赋值行末尾的逗号，让变量存储原始的字符串值，而不是元组。

2. 显式转换字段类型（推荐） #

因为POST请求传递的参数都是字符串，对于模型中的数值、布尔、日期时间类型字段，需要显式转换类型，避免隐式转换失败：

• 整数字段：用int()转换
• 布尔字段：表单提交的勾选值通常是'on'，通过判断字符串是否等于'on'来转换为布尔值
• 日期时间字段：用Django的parse_datetime工具将字符串转为datetime对象
• 文件字段：必须从request.FILES中获取，且表单需设置enctype="multipart/form-data"

修正后的views.py代码 #

from django.shortcuts import render
from django.utils.dateparse import parse_datetime
from .models import Details

def form(request):
    if request.method == 'POST':
        # 移除末尾逗号，并对对应字段做类型转换
        name = request.POST['name']
        roof_age = int(request.POST['roof_age'])
        email = request.POST['email']
        phone = int(request.POST['phone'])
        address = request.POST['address']
        monthly_bill = int(request.POST['monthly_bill'])
        # 处理布尔字段，未勾选时POST中无该键，用get方法避免KeyError
        HOA = request.POST.get('HOA') == 'on'
        battery = request.POST.get('battery') == 'on'
        foundation = request.POST.get('foundation') == 'on'
        roof_type = request.POST['roof_type']
        # 转换日期时间字符串为datetime对象
        availability = parse_datetime(request.POST['availability'])
        # 文件字段从FILES获取
        bill = request.FILES['bill']

        details = Details(
            name=name,
            roof_age=roof_age,
            email=email,
            phone=phone,
            address=address,
            monthly_bill=monthly_bill,
            HOA=HOA,
            battery=battery,
            foundation=foundation,
            roof_type=roof_type,
            availability=availability,
            bill=bill
        )
        
        print(name, roof_age, email, phone, address, monthly_bill, HOA, battery, foundation, roof_type, availability, bill)
        print("数据已保存到数据库")
        details.save()

    return render(request, 'baskin/form.html')

额外注意事项 #

• 表单模板中必须添加enctype="multipart/form-data"属性，才能正确上传文件：

  <form method="POST" enctype="multipart/form-data">
      <!-- 表单内容 -->
  </form>
  

• 对于可能为空的字段，建议用request.POST.get('field_name', default_value)的方式获取，避免抛出KeyError

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