Django执行makemigrations遇循环导入错误，如何用字符串引用解决？

你的Player和Team模型互相导入，形成了循环引用，导致执行makemigrations时出错。解决这个问题的核心是用字符串格式的模型引用替代直接import，不需要在文件顶部导入对方模型。

正确的字符串格式 #

因为两个模型属于同一个应用footballapi，有两种有效写法：

• 简写格式：直接写模型类名的字符串，比如'Team'、'Player'
• 完整格式：'应用名.模型类名'，比如'footballapi.Team'、'footballapi.Player'（推荐用完整格式，避免不同应用出现重名模型时的冲突）

修改后的模型代码 #

Player模型（footballapi/models/player.py）

from django.db import models
from django.contrib.auth.models import User
from footballapi.models.bio import Bio

class Player(models.Model):
    user = models.OneToOneField(User, on_delete=models.CASCADE)
    bio = models.ForeignKey(Bio, on_delete=models.CASCADE)
    # 替换直接导入的Team为字符串引用
    teams = models.ManyToManyField('footballapi.Team', on_delete=models.CASCADE, related_name="members")

Team模型（footballapi/models/team.py）

from django.db import models

# 删掉原来导入Player的语句
class Team(models.Model):
    name = models.CharField(max_length=50)
    # 替换直接导入的Player为字符串引用
    roster_spot = models.ForeignKey('footballapi.Player', on_delete=models.CASCADE)

修改完成后，再执行makemigrations和migrate命令就可以正常生成迁移文件了。

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