Django中JSONField转ArrayField报错：无法将jsonb转为character varying[]

这个问题我之前处理过，PostgreSQL确实没办法直接自动把jsonb类型转换成varchar[]——默认的类型转换逻辑不兼容，所以才会抛出cannot cast type jsonb to character varying[]的错误。下面给你两种可行的解决思路，你可以根据自己的场景选择：

方法一：用原生SQL直接转换（高效适合大数据量） #

这种方式直接通过PostgreSQL的SQL语句完成类型转换，速度更快，适合数据量较大的表。你需要手动修改makemigrations生成的迁移文件，替换原来的AlterField操作：

1. 先执行python manage.py makemigrations生成初始迁移文件（不要执行migrate）
2. 打开生成的迁移文件，替换operations部分为以下内容：

from django.contrib.postgres.fields import ArrayField
from django.db import migrations, models

class Migration(migrations.Migration):
    dependencies = [
        # 这里保留原来的依赖，比如 ('your_app_name', '000x_previous_migration'),
    ]

    operations = [
        # 第一步：用原生SQL修改字段类型并指定正确的转换逻辑
        migrations.RunSQL(
            # 正向迁移SQL：把jsonb数组转成varchar(100)数组
            """
            ALTER TABLE "your_app_name_employee" 
            ALTER COLUMN "locations" TYPE varchar(100)[] 
            USING array(select jsonb_array_elements_text("locations"));
            """,
            # 反向迁移SQL：把varchar数组转回jsonb
            """
            ALTER TABLE "your_app_name_employee" 
            ALTER COLUMN "locations" TYPE jsonb 
            USING to_jsonb("locations");
            """
        ),
        # 第二步：更新Django的模型状态，让迁移记录字段类型的变化
        migrations.AlterField(
            model_name='Employee',
            name='locations',
            field=ArrayField(models.CharField(max_length=100), size=None),
        ),
    ]

注意替换your_app_name为你实际的Django应用名称，表名格式是应用名_模型名（小写）。

方法二：分步骤迁移数据（直观易调试） #

如果你的数据量不大，或者担心转换过程中出现异常，推荐用这种分步迁移的方式，每一步都可控：

1. 同样先执行python manage.py makemigrations生成初始迁移文件（不要执行migrate）
2. 打开迁移文件，替换成以下内容：

from django.contrib.postgres.fields import ArrayField
from django.db import migrations, models

def migrate_locations_data(apps, schema_editor):
    # 获取历史模型（不要直接导入当前模型，避免迁移时的依赖问题）
    Employee = apps.get_model('your_app_name', 'Employee')
    # 遍历所有记录，将原jsonb列表赋值给临时字段
    for employee in Employee.objects.all():
        # 如果原字段中有非字符串元素，可以在这里做转换，比如转成字符串：
        # employee.temp_locations = [str(item) for item in employee.locations]
        employee.temp_locations = employee.locations
        employee.save()

class Migration(migrations.Migration):
    dependencies = [
        # 保留原来的依赖
    ]

    operations = [
        # 1. 添加一个临时字段，用来存转换后的数据
        migrations.AddField(
            model_name='Employee',
            name='temp_locations',
            field=ArrayField(models.CharField(max_length=100), size=None, null=True, blank=True),
        ),
        # 2. 执行数据迁移，把原字段的数据转存到临时字段
        migrations.RunPython(migrate_locations_data),
        # 3. 删除原来的jsonb字段
        migrations.RemoveField(
            model_name='Employee',
            name='locations',
        ),
        # 4. 把临时字段重命名为原来的字段名
        migrations.RenameField(
            model_name='Employee',
            old_name='temp_locations',
            new_name='locations',
        ),
        # 可选：如果需要恢复原字段的默认值和非空设置，添加这一步
        migrations.AlterField(
            model_name='Employee',
            name='locations',
            field=ArrayField(models.CharField(max_length=100), size=None, blank=True, default=list),
        ),
    ]

注意事项 #

• 备份数据库！ 执行任何迁移操作前一定要备份，避免数据丢失。
• 如果原JSONField中存在非字符串类型的元素（比如数字、布尔值），需要在数据转换步骤中手动转成字符串（参考方法二中的注释）。
• 方法一的SQL转换只适用于原jsonb字段是纯字符串列表的情况，如果数组里嵌套了对象或其他复杂结构，需要先处理数据再转换。

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