Django DRF中如何序列化ChoiceField并返回可选选项

这个需求完全可以只修改现有TodoSerializer类实现，不需要新增任何独立的模型、序列化类或接口，几行代码就能搞定。

为什么原来的代码前端拿不到选项？ #

ModelSerializer的默认逻辑是只自动映射模型中定义的数据库字段，也就是你写的priority = models.CharField(...)这个持久化字段：它只会负责把每个Todo实例存储的priority具体值序列化返回，同时自动完成前端传值的合法性校验。但你写在模型类内部的priority_choices列表是类级别的普通常量，不是数据库里存储的实例字段，DRF默认不会把它放到序列化输出里，所以前端自然拿不到这份选项列表。

直接替换现有serializers.py的TodoSerializer代码即可 #

from rest_framework import serializers
from .models import Todo


class TodoSerializer(serializers.ModelSerializer):
    # 新增一个序列化字段，专门承载priority的可选选项，不干扰原有priority字段的功能
    priority_options = serializers.SerializerMethodField()

    class Meta:
        model = Todo
        # 把新增字段加入输出列表，原有字段顺序保持不变
        fields = ('id', 'title', 'description', 'completed', 'priority', 'priority_options')

    def get_priority_options(self, obj):
        # 直接从模型已配置的priority字段上动态读取choices，不需要硬编码选项
        priority_model_field = self.Meta.model._meta.get_field('priority')
        # 转成前端下拉框可直接使用的键值结构
        return [
            {"value": choice[0], "label": choice[1]}
            for choice in priority_model_field.choices
        ]

方案说明 #

• 原有API功能完全不受影响：priority字段的读写、校验逻辑和之前完全一致，前端提交的更新值会自动按照模型配置的choices做合法性校验，合法值会正常写入数据库，不会破坏现有流程
• 不需要重复维护选项列表：返回给前端的选项全部动态从模型定义中读取，后续如果要在models.py里增删priority的可选值，完全不需要改动serializers的代码，接口返回的选项会自动同步更新
• 前端接入成本极低：拿到接口返回的Todo列表/详情数据后，直接取任意一条数据里的priority_options数组，就能直接绑定到React的下拉选择框组件上，不需要额外发请求拉取选项配置
• 适配当前项目阶段：如果后续觉得列表接口里每个条目都重复返回一样的options太占带宽，再调整视图逻辑把options放到响应的公共元数据里就行，目前这种写法是维护成本最低、实现最简单的方案

新手常见踩坑点（对应你之前尝试报语法错误的原因） #

• 直接把模型类里的priority_choices普通列表加到serializer的fields配置里——DRF只会处理模型定义的数据库字段，类级别的普通常量不是数据库字段，无法被自动序列化输出
• 手动在序列化方法里硬编码选项时，没有把元组结构转成JSON可序列化的字典结构，导致接口抛出类型序列化错误

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