修改Django默认用户为AbstractUser执行migrate时遇模型解析错误

问题详情 #

尝试将Django默认用户模型替换为AbstractUser，执行python3 manage.py migrate时触发错误：

ValueError: Related model 'useraccount.user' cannot be resolved

已在settings.py中配置AUTH_USER_MODEL，自定义User模型仅包含pass语句，完整报错输出如下：

┌──(venv)─(neo㉿neo)-[~/…/Software Development/DjangoReact/-Blog/backend]
└─$ python3 manage.py migrate       
Operations to perform:
  Apply all migrations: admin, auth, blogapp, contenttypes, forumapp, sessions, token_blacklist, useraccount
Running migrations:
  Applying useraccount.0001_initial...Traceback (most recent call last):
  File "/home/neo/Documents/Software Development/DjangoReact/-Blog/backend/manage.py", line 22, in <module>
    main()
  File "/home/neo/Documents/Software Development/DjangoReact/-Blog/backend/manage.py", line 18, in main
    execute_from_command_line(sys.argv)
  File "/home/neo/Documents/Software Development/DjangoReact/-Blog/backend/venv/lib/python3.10/site-packages/django/core/management/__init__.py", line 446, in execute_from_command_line
    utility.execute()
  File "/home/neo/Documents/Software Development/DjangoReact/-Blog/backend/venv/lib/python3.10/site-packages/django/core/management/__init__.py", line 440, in execute
    self.fetch_command(subcommand).run_from_argv(self.argv)
  File "/home/neo/Documents/Software Development/DjangoReact/-Blog/backend/venv/lib/python3.10/site-packages/django/core/management/base.py", line 402, in run_from_argv
    self.execute(*args, **cmd_options)
  File "/home/neo/Documents/Software Development/DjangoReact/-Blog/backend/venv/lib/python3.10/site-packages/django/core/management/base.py", line 448, in execute
    output = self.handle(*args, **options)
  File "/home/neo/Documents/Software Development/DjangoReact/-Blog/backend/venv/lib/python3.10/site-packages/django/core/management/base.py", line 96, in wrapped
    res = handle_func(*args, **kwargs)
  File "/home/neo/Documents/Software Development/DjangoReact/-Blog/backend/venv/lib/python3.10/site-packages/django/core/management/commands/migrate.py", line 349, in handle
    post_migrate_state = executor.migrate(
  File "/home/neo/Documents/Software Development/DjangoReact/-Blog/backend/venv/lib/python3.10/site-packages/django/db/migrations/executor.py", line 135, in migrate
    state = self._migrate_all_forwards(
  File "/home/neo/Documents/Software Development/DjangoReact/-Blog/backend/venv/lib/python3.10/site-packages/django/db/migrations/executor.py", line 167, in _migrate_all_forwards
    state = self.apply_migration(
  File "/home/neo/Documents/Software Development/DjangoReact/-Blog/backend/venv/lib/python3.10/site-packages/django/db/migrations/executor.py", line 252, in apply_migration
    state = migration.apply(state, schema_editor)
  File "/home/neo/Documents/Software Development/DjangoReact/-Blog/backend/venv/lib/python3.10/site-packages/django/db/migrations/migration.py", line 130, in apply
    operation.database_forwards(
  File "/home/neo/Documents/Software Development/DjangoReact/-Blog/backend/venv/lib/python3.10/site-packages/django/db/migrations/operations/models.py", line 96, in database_forwards
    schema_editor.create_model(model)
  File "/home/neo/Documents/Software Development/DjangoReact/-Blog/backend/venv/lib/python3.10/site-packages/django/db/backends/base/schema.py", line 442, in create_model
    sql, params = self.table_sql(model)
  File "/home/neo/Documents/Software Development/DjangoReact/-Blog/backend/venv/lib/python3.10/site-packages/django/db/backends/base/schema.py", line 216, in table_sql
    definition, extra_params = self.column_sql(model, field)
  File "/home/neo/Documents/Software Development/DjangoReact/-Blog/backend/venv/lib/python3.10/site-packages/django/db/backends/base/schema.py", line 346, in column_sql
    field_db_params = field.db_parameters(connection=self.connection)
  File "/home/neo/Documents/Software Development/DjangoReact/-Blog/backend/venv/lib/python3.10/site-packages/django/db/models/fields/related.py", line 1183, in db_parameters
    target_db_parameters = self.target_field.db_parameters(connection)
  File "/home/neo/Documents/Software Development/DjangoReact/-Blog/backend/venv/lib/python3.10/site-packages/django/db/models/fields/related.py", line 1060, in target_field
    return self.foreign_related_fields[0]
  File "/home/neo/Documents/Software Development/DjangoReact/-Blog/backend/venv/lib/python3.10/site-packages/django/utils/functional.py", line 57, in __get__
    res = instance.__dict__[self.name] = self.func(instance)
  File "/home/neo/Documents/Software Development/DjangoReact/-Blog/backend/venv/lib/python3.10/site-packages/django/db/models/fields/related.py", line 747, in foreign_related_fields
    rhs_field for lhs_field, rhs_field in self.related_fields if rhs_field
  File "/home/neo/Documents/Software Development/DjangoReact/-Blog/backend/venv/lib/python3.10/site-packages/django/utils/functional.py", line 57, in __get__
    res = instance.__dict__[self.name] = self.func(instance)
  File "/home/neo/Documents/Software Development/DjangoReact/-Blog/backend/venv/lib/python3.10/site-packages/django/db/models/fields/related.py", line 734, in related_fields
    return self.resolve_related_fields()
  File "/home/neo/Documents/Software Development/DjangoReact/-Blog/backend/venv/lib/python3.10/site-packages/django/db/models/fields/related.py", line 1103, in resolve_related_fields
    related_fields = super().resolve_related_fields()
  File "/home/neo/Documents/Software Development/DjangoReact/-Blog/backend/venv/lib/python3.10/site-packages/django/db/models/fields/related.py", line 712, in resolve_related_fields
    raise ValueError(
ValueError: Related model 'useraccount.user' cannot be resolved

解决方法 #

1. 修正AUTH_USER_MODEL配置格式 #

确保settings.py中的配置使用首字母大写的模型名，正确格式：

AUTH_USER_MODEL = 'useraccount.User'

报错中的useraccount.user是小写模型名，不符合Django对模型引用的要求（必须匹配模型类的实际名称）。

2. 确认自定义User模型定义正确 #

即使仅保留pass，也要保证模型继承AbstractUser且所在应用已注册：

# useraccount/models.py
from django.contrib.auth.models import AbstractUser
from django.db import models

class User(AbstractUser):
    pass

同时检查settings.py的INSTALLED_APPS中已添加useraccount：

INSTALLED_APPS = [
    # ...其他应用
    'useraccount',
]

3. 清理旧迁移文件（开发环境适用） #

如果之前已为默认用户模型执行过迁移，需重置迁移状态：

• 删除所有应用下migrations目录内的文件（保留__init__.py）
• 删除数据库文件（如db.sqlite3）
• 重新执行命令：

  python3 manage.py makemigrations useraccount
  python3 manage.py migrate
  

注意：此操作会清空数据库，仅用于开发阶段。

4. 检查其他应用的用户模型引用 #

如果其他应用（如blogapp、forumapp）存在硬编码引用默认User模型的代码，替换为动态获取方式：

# 错误写法
from django.contrib.auth.models import User

# 正确写法1：使用get_user_model
from django.contrib.auth import get_user_model
User = get_user_model()

# 正确写法2：在ForeignKey中直接引用配置
from django.conf import settings
author = models.ForeignKey(settings.AUTH_USER_MODEL, on_delete=models.CASCADE)

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