Django同父类继承的两个子模型定义ForeignKey报错排查

这个问题是Django多表继承的特性和Python类命名空间查找规则共同导致的：

1. 当继承的父类是非抽象模型类时，Django会自动给每个子模型生成一个指向父模型的隐式OneToOneField（子模型里默认字段名为appuser_ptr），同时会在父模型AppUser上挂载对应子模型的反向关联描述符。当你在StudentUser的类定义中直接写类名SupervisorUser作为外键参数时，Python类命名空间的查找优先级会先拿到父类上挂载的反向描述符对象，而不是模块级定义的SupervisorUser模型类，就触发了第一个ForeignKey参数无效的报错。
2. 你修改的AppUser.SupervisorUser写法本身不成立：SupervisorUser是定义在模块全局作用域的模型类，不是AppUser的内部类，自然会抛出属性不存在的错误。

根据你的继承设计二选一即可：

方案1：保留多表继承，用字符串形式引用模型 #

这是改动最小的方案，Django支持用字符串格式传入外键关联的模型名，会在所有模型加载完成后再解析关联关系，完全避开类定义阶段的命名空间冲突：

class StudentUser(AppUser):
    objects = StudentManager()
    GPA = models.DecimalField(max_digits=4,decimal_places=2)
    # 字符串传参不需要提前拿到模型类对象
    supervisor = models.ForeignKey('SupervisorUser', on_delete=models.CASCADE)
    # 其余字段省略

方案2：如果不需要单独查AppUser表，改用抽象基类 #

如果你的AppUser只是用来抽离公共字段、不需要单独生成数据表存储数据，直接把它标记为抽象模型即可，Django不会生成隐式的一对一关联，从根源避免这类命名冲突：

class AppUser(AbstractBaseUser, PermissionsMixin):
    # 标记为抽象基类
    class Meta:
        abstract = True
    objects = MyUserManager()
    username = models.CharField(max_length=128)
    email = models.EmailField(max_length=64, unique=True)
    # 其余公共字段省略

改完抽象基类后，外键直接写models.ForeignKey(SupervisorUser, on_delete=models.CASCADE)也能正常运行。

你贴出的代码里SupervisorUser的管理器用的是StudentManager()，如果不是特殊业务设计，属于笔误，建议替换为对应导师模型的管理器，避免后续查询逻辑异常。

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