Django中未清洗的JSONField字符串数据如何转换为列表格式

操作前务必先备份对应表数据，避免误操作导致数据丢失。

方案1：一次性批量修复存量数据（推荐，从根源解决存储问题） #

可以通过Django自定义迁移批量处理所有异常数据：

1. 首先创建空迁移文件：
   python manage.py makemigrations <你的应用名> --empty
2. 打开生成的迁移文件，替换为以下内容，修改对应模型、字段名即可：

import json
import ast
from django.db import migrations

def fix_json_field(apps, schema_editor):
    # 替换为你自己的应用名、模型名
    YourModel = apps.get_model('你的应用名', '你的模型名')
    # 替换为你对应的JSON字段名
    target_field = 'your_json_field'

    for obj in YourModel.objects.all():
        field_val = getattr(obj, target_field)
        # 仅处理字符串类型的异常数据
        if not isinstance(field_val, str):
            continue
        try:
            # 优先用json解析标准JSON格式字符串
            parsed = json.loads(field_val)
        except json.JSONDecodeError:
            try:
                # 解析失败则尝试用ast处理单引号的Python格式列表字符串
                parsed = ast.literal_eval(field_val)
            except (ValueError, SyntaxError):
                # 格式完全错误的数据打印ID方便后续手动处理
                print(f"数据ID {obj.pk} 格式异常，无法解析")
                continue
        # 仅保留解析后为列表的数据，不符合的可根据业务需求调整
        if isinstance(parsed, list):
            setattr(obj, target_field, parsed)
            obj.save(update_fields=[target_field])

class Migration(migrations.Migration):
    dependencies = [
        # 替换为上一个迁移文件的对应标识
        ('你的应用名', '000x_xxxxxx'),
    ]

    operations = [
        migrations.RunPython(fix_json_field)
    ]

3. 执行迁移完成修复：
   python manage.py migrate <你的应用名>

方案2：运行时兼容处理（临时过渡方案） #

如果暂时不想修改存量数据，可以在模型层加一层自动转换逻辑，调用时自动返回列表格式：

import json
import ast
from django.db import models

class YourModel(models.Model):
    # 原有的JSONField字段
    your_json_field = models.JSONField()

    @property
    def your_json_field_parsed(self):
        val = self.your_json_field
        if isinstance(val, str):
            try:
                parsed = json.loads(val)
            except json.JSONDecodeError:
                try:
                    parsed = ast.literal_eval(val)
                except:
                    return []
            return parsed if isinstance(parsed, list) else []
        return val if isinstance(val, list) else []

后续业务代码直接调用your_json_field_parsed属性即可拿到正确的列表格式。

修复导入逻辑避免复现 #

给django-import-export的资源类配置JSONWidget，导入时自动解析为正确的JSON格式：

from import_export import resources, fields
from import_export.widgets import JSONWidget
from .models import YourModel

class YourModelResource(resources.ModelResource):
    your_json_field = fields.Field(
        column_name='导入文件对应列名',
        attribute='your_json_field',
        widget=JSONWidget()
    )

    class Meta:
        model = YourModel

提示：如果数据量超过10万条，建议分批处理数据，避免执行迁移时长时间锁表影响线上业务。

内容的提问来源于stack exchange，提问作者Prosy A.