You need to enable JavaScript to run this app. Django DRF中如何修改模型返回值使接口返回kind字段的显示名称
优惠活动
大模型
产品
解决方案
定价
更多

Django DRF中如何修改模型返回值使接口返回kind字段的显示名称

Django 接口返回choices字段显示值的解决方案

Django admin 能正常显示选项的可读名称,是因为后台自动调用了字段对应的get_<字段名>_display()方法获取映射文本;而默认的ModelSerializer会直接输出字段存储的原始值,不会主动调用这个显示方法,所以接口返回的是数字字符串值。

直接替换kind字段为显示值

如果需要让接口返回的kind字段直接展示对应名称,可直接绑定Django自动生成的显示方法,不需要手动编写元组映射逻辑:

from rest_framework import serializers
from .models import Product


class ProductSerializer(serializers.ModelSerializer):
    # 直接关联模型的choices显示方法,替换原始kind的输出
    kind = serializers.CharField(source='get_kind_display', read_only=True)

    class Meta:
        model = Product
        fields = ['image', 'name', 'kind', 'price', 'description', 'is_featured']

修改完成后接口返回的kind值会替换为元组中定义的可读名称,例如存储值"1"对应"Electronic"、存储值"3"对应"Bedroom",和admin后台展示内容完全一致。

可选适配:同时保留原始存储值和显示值

如果前端既需要原始存储值做交互逻辑判断、又需要显示值做页面渲染,可以新增独立的显示字段,保留原来的kind字段不变:

class ProductSerializer(serializers.ModelSerializer):
    # 新增kind_name字段存储可读名称,原有kind字段保留原始存储值
    kind_name = serializers.CharField(source='get_kind_display', read_only=True)

    class Meta:
        model = Product
        fields = ['image', 'name', 'kind', 'kind_name', 'price', 'description', 'is_featured']

这种结构下接口返回会同时包含两个值:

  • kind: 存储的原始数字字符串(例如"1")
  • kind_name: 对应的可读显示名称(例如"Electronic")

前提校验:需要确认模型中kind字段的定义确实关联了之前声明的PRODUCT_KINDS选项元组,类似如下结构:

# models.py 中的Product模型参考
class Product(models.Model):
    PRODUCT_KINDS = (
        ("1","Electronic"),
        ("2","Furniture"),
        ("3", "Bedroom"),
        ("4","Dining")
    )
    kind = models.CharField(max_length=1, choices=PRODUCT_KINDS)

内容的提问来源于stack exchange,提问作者Ali Ziya ÇEVİK

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.11.14 15:54:03