Django-Oscar扩展AbstractUser时customer.user模型无法解析错误如何解决

问题原因 #

该报错是迁移执行顺序异常导致的：你fork出的customer应用自带的历史迁移文件（0001~0008）中存在关联User模型的外键字段，但你自定义的User模型是在后续生成的0009迁移中才定义的，执行迁移时会优先运行编号更小的0001初始迁移，此时customer.User还未被创建，因此无法解析关联模型。
此外你当前的应用注册方式也不符合Oscar fork应用的规范。

解决步骤 #

1. 修正基础配置 #

• 检查customer/apps.py，确认你fork生成的配置类继承了Oscar原生的CustomerConfig，示例如下：

from oscar.apps.customer.apps import CustomerConfig as CoreCustomerConfig

class CustomerConfig(CoreCustomerConfig):
    name = 'customer'

• 检查customer/models.py，确认你显式定义了继承自Oscar抽象类的User模型：

from oscar.apps.customer.abstract_models import AbstractUser

class User(AbstractUser):
    # 自定义扩展字段写这里
    pass

• 修正settings.py的应用注册配置，将PROJECT_APPS中的"customer"替换为你自定义的配置类：

PROJECT_APPS = [
    "customer.apps.CustomerConfig",
]

你的AUTH_USER_MODEL = "customer.User"配置无需修改。

2. 重置迁移文件（适用于全新未上线项目） #

如果是还未上线的新项目，直接重置迁移即可彻底解决顺序问题：

1. 删除customer/migrations/目录下除__init__.py之外的所有.py和.pyc文件
2. 删除项目根目录下的数据库文件（如sqlite3的db.sqlite3，如果是MySQL/PostgreSQL则删除对应数据库后重新创建空库）
3. 依次执行迁移命令：

./manage.py makemigrations
./manage.py migrate

3. 存量项目兼容方案（已有生产数据） #

如果项目已经上线有存量数据，不能直接重置迁移，可以手动修改迁移依赖：

1. 打开customer/migrations/0001_initial.py，在dependencies列表中添加你0009迁移的依赖：

dependencies = [
    ('customer', '0009_user'),
    # 保留原来的其他依赖项
]

2. 重新执行migrate命令即可。

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