Django表单仅CharField无法渲染问题排查求助

问题现象 #

在Django表单中，仅CharField类型字段无法正常显示，EmailField、基于django-turnstile的TurnstileField等其他字段均可正常渲染。尝试过使用widget_tweaks逐个渲染字段、在Meta类中配置widgets，均未解决问题。

相关代码 #

auth.html #

{% block body %}
        <form action="https://artimaths.com/auth/{{ action }}/" method="POST">
            {% csrf_token %}
            {{ form }}
            <input type="submit" value="Submit">
        </form>
{% endblock %}

views.py #

from django.core.exceptions import ValidationError
from django.http import HttpResponse, HttpResponseRedirect
from django.core.mail import send_mail
from django.template import loader
from .models import Member
from .forms import SignupForm, LoginForm
from modules import context
import hashlib
import re

def signage(request, action):
    t = loader.get_template("auth.html")
    if action != "register" and action != "login" and action != "logout":
        return HttpResponse(STATUS_DICT[str(400)] + str(400))

    if action == "register":
        req_context["form"] = SignupForm
        req_context["form_class"] = SignupForm
    elif action == "login":
        req_context["form"] = LoginForm
        req_context["form_class"] = LoginForm


    if req_context["status"] is not 200:
        return HttpResponse(STATUS_DICT[str(req_context["status"]) + req_context["status"]])
    return HttpResponse(t.render(req_context, request))

forms.py（原错误代码） #

from django import forms
from turnstile.fields import TurnstileField
from .models import Member

class SignupForm(forms.Form):
    username = forms.CharField(label="Username"),  # 多余的逗号
    password = forms.CharField(label="Password"),  # 多余的逗号
    email = forms.EmailField(label="Email")
    terms = forms.BooleanField(label="I agree with the Terms of Service and Privacy Policy of Artimaths")
    captcha = TurnstileField(theme="dark", size="compact")
    class Meta:
        model = Member
        fields = ("username", "password", "email", "terms", "captcha")

class LoginForm(forms.Form):
    username = forms.CharField(label="Username"),  # 多余的逗号
    password = forms.CharField(label="Password"),  # 多余的逗号
    captcha = TurnstileField(theme="dark", size="compact")

    class Meta:
        model = Member
        fields = ("username", "password", "captcha")

models.py #

import uuid
from django.db import models

class Member(models.Model):
    userid = models.UUIDField(primary_key = True, default = uuid.uuid4, editable = False)
    name = models.CharField(max_length = 255)
    email = models.EmailField()
    password_hash = models.CharField(max_length = 512)

    def __str__(self):
        return f"{self.name} ({self.userid})"

问题原因 #

在forms.py的SignupForm和LoginForm中，CharField字段定义末尾多了逗号，导致这些字段被定义成了元组（(forms.CharField(...),)），而非CharField类的实例。Django无法识别元组类型的字段，因此无法正常渲染。

修正方案 #

去掉CharField字段定义末尾的逗号，修改后的forms.py代码如下：

from django import forms
from turnstile.fields import TurnstileField
from .models import Member

class SignupForm(forms.Form):
    username = forms.CharField(label="Username")
    password = forms.CharField(label="Password")
    email = forms.EmailField(label="Email")
    terms = forms.BooleanField(label="I agree with the Terms of Service and Privacy Policy of Artimaths")
    captcha = TurnstileField(theme="dark", size="compact")
    class Meta:
        model = Member
        fields = ("username", "password", "email", "terms", "captcha")

class LoginForm(forms.Form):
    username = forms.CharField(label="Username")
    password = forms.CharField(label="Password")
    captcha = TurnstileField(theme="dark", size="compact")

    class Meta:
        model = Member
        fields = ("username", "password", "captcha")

额外优化建议 #

你的SignupForm和LoginForm继承自forms.Form，但又添加了Meta类指定model，属于冗余配置。如果是基于模型的表单，建议直接继承forms.ModelForm，可自动关联模型字段，减少重复代码。

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