Django如何处理site-packages中自定义Group字段生成的迁移文件

直接修改第三方模型动态加字段导致迁移生成到site-packages目录的问题，不需要全量迁移auth应用的所有内置迁移，按以下步骤操作即可：

方案一：直接在Group表新增字段（使用体验和原生字段一致） #

1. 保留字段注册逻辑，将代码放到项目自有app的启动加载位置（比如自有app的models.py中，确保Django启动时能正常执行）：

from django.contrib.auth.models import Group
from django.db import models

Group.add_to_class('description', models.TextField(max_length=250, default="", verbose_name="分组描述"))

2. 不要执行makemigrations让Django自动生成迁移，手动在你自己的业务app（建议选和权限、用户相关的自有app，例如命名为core、users的自定义app）的migrations目录下新建迁移文件，文件名按当前app的迁移序号顺延，例如当前app最后一个迁移为0005_xxx.py，则新建0006_group_add_description.py，内容如下：

from django.db import migrations, models


class Migration(migrations.Migration):
    dependencies = [
        # 替换为当前自有app的上一个迁移文件名
        ('core', '0005_xxx'),
        # 对应你当前Django版本auth应用的最后一个内置迁移，后续Django升级新增auth迁移不需要修改此处，依赖链会自动按顺序执行
        ('auth', '0012_alter_user_first_name_max_length'),
    ]

    operations = [
        migrations.AddField(
            model_name='group',
            name='description',
            field=models.TextField(default='', max_length=250, verbose_name="分组描述"),
        ),
    ]

3. 在项目settings.py中添加如下配置，阻止Django尝试向auth的官方迁移目录写入新迁移文件：

MIGRATION_MODULES = {
    'auth': 'django.contrib.auth.migrations',
}

该方案的优势：

• 不需要拷贝auth应用的所有内置迁移，后续Django版本迭代时，官方新增的auth迁移会被正常识别执行，不需要手动同步维护
• 自定义迁移文件存放在自有app目录下，可以正常纳入版本管理，部署时执行migrate命令会按依赖顺序自动完成字段添加
• 字段使用体验和原生字段完全一致，所有调用Group模型的位置都可以直接通过group.description读写字段值

方案二：无侵入扩展（零修改官方表结构，长期维护更稳定） #

如果后续需要为Group扩展更多字段或自定义方法，更推荐用一对一关联的方式做扩展，完全不触碰官方模型的表结构，从根源避免迁移冲突：

from django.contrib.auth.models import Group
from django.db import models


class GroupProfile(models.Model):
    group = models.OneToOneField(Group, on_delete=models.CASCADE, related_name="profile")
    description = models.TextField(max_length=250, default="", verbose_name="分组描述")

使用时通过group.profile.description即可访问字段，所有扩展逻辑都收敛在自定义模型中，Django升级时完全不需要考虑和auth内置迁移的兼容问题，适合长期维护的项目。

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