Django自定义默认User类迁移报错ValueError：如何解决？

这个错误我之前也碰到过，本质是因为在配置AUTH_USER_MODEL之前，已经有依赖默认User模型的迁移（比如admin应用的LogEntry表）被执行过，或者你的自定义User模型配置有小疏漏。下面分场景给你解决方案：

1. 先确认自定义User模型的正确性 #

先检查music/models.py里的代码是否符合规范：

• 正确继承AbstractUser，且没有拼写错误
• 模型类名确实是User
• 导入模块完整，示例代码如下：

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

class User(AbstractUser):
    # 你的自定义字段示例
    bio = models.TextField(blank=True, verbose_name="个人简介")
    birth_date = models.DateField(null=True, blank=True, verbose_name="出生日期")

2. 开发环境快速解决（无重要数据） #

如果是开发阶段还没有积累重要数据，最直接的方法是重置迁移和数据库：

• 删除所有应用下migrations文件夹内的文件（保留__init__.py不要删）
• 删除本地数据库文件（比如SQLite的db.sqlite3）
• 重新执行迁移命令：

python manage.py makemigrations
python manage.py migrate

3. 生产环境解决方案（保留数据） #

如果是已有数据的生产环境，绝对不能直接重置，按以下步骤操作：

1. 先备份数据库，这一步是重中之重，避免数据丢失
2. 为music应用创建一个空迁移文件：

python manage.py makemigrations --empty music

3. 打开这个新建的空迁移文件，添加修改LogEntry关联字段的代码：

from django.db import migrations, models

def update_log_entry_user(apps, schema_editor):
    # 动态获取模型
    LogEntry = apps.get_model('admin', 'LogEntry')
    CustomUser = apps.get_model('music', 'User')
    # 确保LogEntry的user字段关联到自定义User
    LogEntry._meta.get_field('user').remote_field.model = CustomUser

class Migration(migrations.Migration):
    dependencies = [
        # 填写你当前music应用最新的迁移编号，比如('music', '0001_initial')
        ('music', '0001_initial'),
    ]

    operations = [
        migrations.RunPython(update_log_entry_user),
        migrations.AlterField(
            model_name='logentry',
            name='user',
            field=models.ForeignKey(
                on_delete=models.CASCADE,
                to='music.User',
                verbose_name='user'
            ),
        ),
    ]

4. 执行迁移命令完成修改：

python manage.py migrate

4. 检查全局配置与代码引用 #

• 确认settings.py里INSTALLED_APPS已经添加'music'，且AUTH_USER_MODEL = 'music.User'（注意是大写的User，要和模型类名严格对应）
• 检查项目中所有引用用户模型的代码，统一使用settings.AUTH_USER_MODEL替代直接写'auth.User'或'music.user'（小写）：

from django.conf import settings
from django.db import models

class Playlist(models.Model):
    creator = models.ForeignKey(
        settings.AUTH_USER_MODEL,
        on_delete=models.CASCADE,
        related_name='playlists'
    )

另外要记住：Django要求AUTH_USER_MODEL必须在第一次执行迁移前就配置好，否则很容易出现这类关联错误，开发初期就要确定好用户模型的结构。

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