Django Rest Framework响应格式异常：列表序列化问题

问题根源 #

你遇到的核心问题是：用CharField存储的是字符串格式的“伪列表”（比如"['Tom', 'Jerry']"），DRF的ListField会把字符串当成可迭代对象，逐个字符拆分，最终返回单个字符组成的数组。换成JSONField/TextField没解决，大概率是数据库旧数据仍为字符串格式，或序列化器配置未匹配字段类型。

1. 修正模型字段（推荐方案） #

直接使用Django的JSONField（Django 3.1+支持，SQLite完全兼容），它会自动处理数组的存储与序列化：

# models.py
from django.db import models

class Show(models.Model):
    # 其他字段...
    cast = models.JSONField(default=list)  # 默认空列表，确保存储的是标准JSON数组

2. 迁移旧数据 #

如果之前用CharField存的是字符串格式的“列表”，需要批量转成标准JSON数组：

# 执行：python manage.py shell
import ast
from your_app.models import Show

for show in Show.objects.all():
    if show.cast and isinstance(show.cast, str):
        try:
            # 将字符串转成Python列表，自动适配JSON格式
            show.cast = ast.literal_eval(show.cast)
            show.save()
        except (SyntaxError, ValueError):
            # 处理格式错误的数据，设为空列表
            show.cast = []
            show.save()

3. 配置序列化器 #

现在用普通ModelSerializer即可，无需额外指定ListField，JSONField会自动序列化为数组：

# serializers.py
from rest_framework import serializers
from your_app.models import Show

class ShowSerializer(serializers.ModelSerializer):
    class Meta:
        model = Show
        fields = ['id', 'name', 'cast']  # 包含你的其他业务字段

备选方案（若必须用TextField） #

如果因特殊原因不能用JSONField，可自定义序列化字段手动转换：

# serializers.py
from rest_framework import serializers
import ast

class CastListField(serializers.ListField):
    def to_representation(self, value):
        if isinstance(value, str):
            try:
                return ast.literal_eval(value)
            except (SyntaxError, ValueError):
                return []
        return super().to_representation(value)

class ShowSerializer(serializers.ModelSerializer):
    cast = CastListField(child=serializers.CharField())
    
    class Meta:
        model = Show
        fields = ['id', 'name', 'cast']

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