Django PostgreSQL：字符串列迁移至数组列的问题求助

问题原因 #

PostgreSQL中，Django的CharField对应varchar类型，而ArrayField(CharField())映射的是text[]数组类型。直接将varchar值放入数组会触发类型不兼容的DataError，需要显式处理类型转换。

解决方案 #

方案1：原生SQL显式类型转换 #

执行带类型转换的更新语句，把tag字段的值转为text后再放入数组：

UPDATE form_builder_formfield SET tags = ARRAY[tag::text] WHERE tag IS NOT NULL;

如果要集成到Django迁移文件中：

from django.db import migrations, connections

def migrate_tag_to_tags(apps, schema_editor):
    with connections['default'].cursor() as cursor:
        cursor.execute("UPDATE form_builder_formfield SET tags = ARRAY[tag::text] WHERE tag IS NOT NULL;")

class Migration(migrations.Migration):
    dependencies = [
        # 替换为你新增tags字段的迁移文件名
        ('form_builder', '000X_add_tags_field'),
    ]

    operations = [
        migrations.RunPython(migrate_tag_to_tags),
    ]

方案2：Django QuerySet批量更新 #

用Django的Func构造符合类型要求的数组，避免直接写原生SQL：

from django.db.models import Func
from form_builder.models import FormField

# 将tag转为text类型后包装成数组
FormField.objects.filter(tag__isnull=False).update(
    tags=Func(Func('tag', function='text'), function='ARRAY')
)

注意事项 #

• 确认模型中tags字段定义正确：

  from django.contrib.postgres.fields import ArrayField
  from django.db import models
  
  class FormField(models.Model):
      tag = models.CharField(max_length=255, null=True, blank=True)
      tags = ArrayField(models.CharField(max_length=255), null=True, blank=True)
  

• 迁移前务必备份数据，防止操作失误导致数据丢失。
• 若仍报错，检查tag字段是否包含特殊字符（如引号、方括号），这类字符可能破坏数组结构，需先清理再迁移。

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