从SQLite迁移至NeonDB(PostgreSQL)时遇bigint转uuid错误求助

模型代码 #

class Pet(models.Model):
    id = models.BigIntegerField(blank=True, null=True)
    uuid = models.UUIDField(default=uuid.uuid4, primary_key=True, blank=False, null=False)
    name = models.CharField(max_length=150, default="Unnamed")
    animal = models.CharField(max_length=150, default="")
    breed = models.CharField(max_length=150, default="")
    location = models.CharField(max_length=150, blank=True, null=True)
    image = models.ImageField(upload_to='images/', default='images/pet.png', blank=True, null=True)
    description = models.TextField(max_length=1000, blank=True, null=True)
    info = models.TextField(max_length=1000, blank=True, null=True)

    def __str__(self):
        return f"{self.animal} - {self.name} - {self.breed}"

class PetAttachmentImage(models.Model):
    pet = models.ForeignKey(Pet, to_field='uuid', on_delete=models.CASCADE, related_name="pet")
    image = models.ImageField(upload_to='images/pet_attachments_images/', blank=False, null=False)

问题场景 #

基于SQLite开发的Django后端，部署到采用PostgreSQL的NeonDB时，迁移本地数据触发错误：psycopg2.errors.CannotCoerce: cannot cast type bigint to uuid。已确认使用uuid作为Pet模型主键，显式定义id字段只是为了替代默认生成的id列，实际不需要使用该字段，不理解为何会触发类型转换错误。

1. 冗余字段引发混淆：当指定uuid为Pet的主键后，Django不会自动生成默认的id主键，显式添加的BigInteger类型id字段属于冗余字段。SQLite对字段类型约束宽松，本地开发时该字段可能被自动填充数值，数据导出时容易和uuid字段的值产生混淆。
2. PostgreSQL类型约束严格：PostgreSQL对数据类型校验非常严格，一旦数据导入过程中，某个BigInteger类型的值被尝试插入或关联到UUID类型的字段（比如Pet的uuid主键，或PetAttachmentImage的pet外键），就会触发类型转换错误。

1. 移除冗余的id字段 #

修改Pet模型，删除id = models.BigIntegerField(blank=True, null=True)这一行，修正后的模型如下：

import uuid
from django.db import models

class Pet(models.Model):
    uuid = models.UUIDField(default=uuid.uuid4, primary_key=True, blank=False, null=False)
    name = models.CharField(max_length=150, default="Unnamed")
    animal = models.CharField(max_length=150, default="")
    breed = models.CharField(max_length=150, default="")
    location = models.CharField(max_length=150, blank=True, null=True)
    image = models.ImageField(upload_to='images/', default='images/pet.png', blank=True, null=True)
    description = models.TextField(max_length=1000, blank=True, null=True)
    info = models.TextField(max_length=1000, blank=True, null=True)

    def __str__(self):
        return f"{self.animal} - {self.name} - {self.breed}"

class PetAttachmentImage(models.Model):
    pet = models.ForeignKey(Pet, to_field='uuid', on_delete=models.CASCADE, related_name="pet")
    image = models.ImageField(upload_to='images/pet_attachments_images/', blank=False, null=False)

2. 同步迁移到NeonDB #

• 生成新的迁移文件：

  python manage.py makemigrations
  

• 切换数据库配置为NeonDB的PostgreSQL，执行迁移同步：

  python manage.py migrate
  

3. 重新导出并导入数据 #

• 从本地SQLite导出数据（排除系统默认权限和内容类型表，避免冲突）：

  python manage.py dumpdata --exclude auth.permission --exclude contenttypes > data.json
  

• 编辑data.json，检查所有Pet模型的条目，确保删除了id字段，只保留uuid及其他业务字段。
• 将清理后的数据导入NeonDB：

  python manage.py loaddata data.json
  

备选方案（不推荐） #

如果暂时无法修改模型，可直接编辑导出的data.json：

• 删除所有Pet条目中的id字段
• 确保PetAttachmentImage条目中的pet字段值为对应Pet的uuid字符串（而非id的数值）
• 再执行数据导入操作

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