Django使用forms.ModelChoiceField时select下拉选项显示为空如何解决

选项渲染为空核心有两个原因：

1. 模板循环逻辑错误：{% for rol in form.rol %}遍历的是Django表单BoundField生成的选项包装对象，不是Rol模型实例，直接访问.pk、.name属性取不到任何有效值。
2. Rol模型未定义__str__方法：ModelChoiceField默认调用模型的__str__方法生成选项显示文本，没定义的话无法正确读取name字段作为选项内容。
   另外原有代码里还有几处不规范写法会埋下运行异常隐患。

1. 修正模型定义 #

给Rol模型添加__str__方法，指定选项显示的文本内容：

class Rol(TimeStampedModel):
    name = models.CharField(verbose_name=_('Name'), max_length=100)
    active = models.BooleanField(verbose_name=_('Active'), default=True)
    sort_order = models.IntegerField(verbose_name=_('Sort Order'), default=0)

    def __str__(self):
        return self.name

2. 修正表单定义 #

删掉冗余的类属性rols = None，初始查询集用空查询集避免类加载异常，initial取值用安全写法避免数据不存在时报错：

class ProfileForm(forms.ModelForm):
    rol = forms.ModelChoiceField(
        queryset=Rol.objects.none(),
        initial=Rol.objects.filter(pk=1).first()
    )
    class Meta:
        model = User
        fields = ['email', 'first_name', 'last_name','rut', 'phone', 'gender', 'rol']
        exclude = ('username',)

    def __init__(self, user=None, *args, **kwargs):
        self.user = user
        super().__init__(*args, **kwargs)
        # 可按需加过滤条件，比如只展示激活的角色，按排序字段排序
        self.fields['rol'].queryset = Rol.objects.filter(active=True).order_by('sort_order')
        # 如果需要适配前端UI样式，直接在这里给字段加CSS类即可，不需要模板里硬写标签属性
        self.fields['rol'].widget.attrs.update({
            'class': 'ui dropdown',
            'maxlength': '100'
        })

3. 修正模板代码 #

两种写法选其一即可：

写法1：保留自定义手写option结构 #

注意遍历选项时用Django封装的属性取值，补全选中状态判断，删掉select标签上无效的type="mail"属性：

<tr>
    <td class="table-text typo-grey">
        <label class="float-left" for="{{ form.rol.id_for_label }}">Rol</label>
    </td>
    <td class="rol centered">
        <div class="ui input">
            <select id="id_{{form.rol.html_name}}" name="{{form.rol.html_name}}" maxlength="100">
                {% for option in form.rol %}
                <option value="{{ option.data.value }}" {% if option.data.selected %}selected{% endif %}>
                    {{ option.data.label }}
                </option>
                {% endfor %}
            </select>
        </div>
    </td>
</tr>

写法2：直接渲染表单字段（推荐） #

不需要手写循环和option标签，Django会自动生成正确的选项、值、选中状态，代码更简洁不容易出错：

<tr>
    <td class="table-text typo-grey">
        <label class="float-left" for="{{ form.rol.id_for_label }}">Rol</label>
    </td>
    <td class="rol centered">
        <div class="ui input">
            {{ form.rol }}
        </div>
    </td>
</tr>

• 不要在字段定义时直接用Rol.objects.get(pk=1)设置初始值，如果对应数据被删除，表单类加载时就会直接抛出500错误，用filter().first()会在数据不存在时返回None，不会中断程序运行。
• select标签本身没有type属性，写了也不会生效，属于冗余代码可以直接删除。
• 如果需要自定义选项的显示格式，可以通过自定义字段的label_from_instance方法实现，不需要在模板里硬取模型属性。

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