Django多对多字段主键修改：已填充表转UUID的最佳迁移方案

好问题！在Django里修改多对多关联表的主键——尤其是已经填充了数据的情况——完全是可行的，但不能直接依赖自动迁移搞定，得按步骤手动处理，避免踩坑。下面我给你拆解最佳方案：

先给你吃颗定心丸：已填充数据的多对多关联表完全可以把默认的自增整数主键改成UUID。不过Django的自动迁移工具无法处理这种主键类型变更的复杂场景，必须手动编写迁移脚本逐步操作。

假设我们有两个基础模型，自动生成的多对多关联表为myapp_author_books：

from django.db import models

class Book(models.Model):
    title = models.CharField(max_length=100)

class Author(models.Model):
    name = models.CharField(max_length=50)
    books = models.ManyToManyField(Book)

步骤1：给关联表添加UUID字段 #

首先生成一个空迁移文件：

python manage.py makemigrations myapp --empty

编辑这个迁移文件，添加一个允许为空的UUID字段（后续会填充值）：

from django.db import migrations, models
import uuid

class Migration(migrations.Migration):
    dependencies = [
        ('myapp', '000X_previous_migration'),  # 替换成你当前的最后一个迁移编号
    ]

    operations = [
        migrations.AddField(
            model_name='author_books',
            name='uuid_id',
            field=models.UUIDField(default=uuid.uuid4, null=True),
        ),
    ]

运行迁移：

python manage.py migrate myapp

步骤2：给已有记录填充UUID值 #

接下来编写数据迁移，给所有旧记录生成UUID。再次生成空迁移：

python manage.py makemigrations myapp --empty --name populate_uuid_for_author_books

编辑迁移文件，批量填充UUID：

from django.db import migrations
import uuid

def populate_uuid(apps, schema_editor):
    AuthorBooks = apps.get_model('myapp', 'author_books')
    # 批量更新优化性能，避免逐条save
    records = []
    for record in AuthorBooks.objects.all():
        record.uuid_id = uuid.uuid4()
        records.append(record)
    AuthorBooks.objects.bulk_update(records, ['uuid_id'])

class Migration(migrations.Migration):
    dependencies = [
        ('myapp', '000Y_add_uuid_field'),  # 替换成上一步的迁移编号
    ]

    operations = [
        migrations.RunPython(populate_uuid),
    ]

运行迁移：

python manage.py migrate myapp

步骤3：切换UUID为主键并移除旧主键 #

现在要把UUID字段设为主键，同时移除原来的自增id。生成空迁移：

python manage.py makemigrations myapp --empty --name change_author_books_pk_to_uuid

编辑迁移文件完成主键切换：

from django.db import migrations, models
import uuid

class Migration(migrations.Migration):
    dependencies = [
        ('myapp', '000Z_populate_uuid'),  # 替换成上一步的迁移编号
    ]

    operations = [
        # 先解除旧id的主键约束
        migrations.AlterField(
            model_name='author_books',
            name='id',
            field=models.AutoField(primary_key=False),
        ),
        # 把uuid_id设为主键并设为非空
        migrations.AlterField(
            model_name='author_books',
            name='uuid_id',
            field=models.UUIDField(default=uuid.uuid4, primary_key=True, serialize=False),
        ),
        # 删除旧的自增id字段
        migrations.RemoveField(
            model_name='author_books',
            name='id',
        ),
        # 可选：把uuid_id重命名为id，保持字段名和默认一致
        migrations.RenameField(
            model_name='author_books',
            old_name='uuid_id',
            new_name='id',
        ),
    ]

运行迁移：

python manage.py migrate myapp

步骤4：更新自定义关联表模型（如果适用） #

如果你的多对多关系是通过through指定了自定义关联表，还要同步更新模型：

from django.db import models
import uuid

class Book(models.Model):
    title = models.CharField(max_length=100)

class Author(models.Model):
    name = models.CharField(max_length=50)
    books = models.ManyToManyField(Book, through='AuthorBook')

class AuthorBook(models.Model):
    id = models.UUIDField(primary_key=True, default=uuid.uuid4)
    author = models.ForeignKey(Author, on_delete=models.CASCADE)
    book = models.ForeignKey(Book, on_delete=models.CASCADE)

自动生成的关联表无需这一步，Django会自动识别新的主键类型。

• 先备份数据：操作前一定要全量备份数据库，避免迁移出错导致数据丢失。
• 测试环境验证：所有步骤先在测试环境跑一遍，确认无问题再部署到生产环境。
• 大表优化：如果关联表数据量极大，填充UUID时可以用更高效的批量操作（比如直接写SQL），避免Python循环的性能瓶颈。

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