Django模型迁移失败：执行migrate时触发TypeError

嘿，我来帮你排查这个Django migrate时碰到的TypeError问题！这类错误大多和模型定义、迁移文件的细节有关，我整理了几个最常见的坑，你可以逐一排查：

1. 模型字段参数遗漏或错误 #

这是最常见的原因，比如：

• 忘记给CharField指定必填的max_length参数：

  # 错误示例
  class Product(models.Model):
      name = models.CharField()  # 缺少max_length，直接触发TypeError
  

  解决：补上合理长度的max_length，比如models.CharField(max_length=255)

• 用可变对象作为字段默认值：比如列表、字典这类可变对象，Django不允许直接作为默认值，会引发类型错误：

  # 错误示例
  class Post(models.Model):
      tags = models.JSONField(default=[])  # 可变对象作为默认值会出问题
  

  解决：改用可调用对象，比如default=list或者自定义一个返回空列表的函数

2. 迁移文件存在语法或逻辑错误 #

有时候自动生成的迁移文件可能因为模型变更不连贯出现问题，或者你手动修改过迁移文件导致语法错误。

• 解决步骤：
  • 先删除最近生成的迁移文件（注意别删0001_initial.py这类初始迁移，除非你确定可以重置）
  • 重新运行 python manage.py makemigrations 生成正确的迁移文件
  • 再执行 python manage.py migrate 尝试迁移

3. 模型关联字段配置错误 #

比如ForeignKey、OneToOneField的to参数写错了，引用了不存在的模型，或者路径错误：

# 错误示例：拼写错误的模型名称
class Order(models.Model):
    customer = models.ForeignKey('Customr', on_delete=models.CASCADE)  # 应该是Customer

解决：检查关联模型的名称是否正确，跨app引用时要写全路径，比如'accounts.Customer'

4. 自定义字段/管理器的代码问题 #

如果你的模型用了自定义字段或者自定义管理器，可能是这些自定义代码里存在TypeError，比如自定义字段的__init__方法参数不符合要求，或者管理器的方法返回值异常。

• 解决：仔细检查自定义代码，确保所有方法的参数、返回值都符合Django的规范，比如自定义字段要正确继承models.Field，并重写to_python、get_prep_value这类必要方法

5. Django版本兼容性问题 #

某些字段或参数在不同Django版本中的用法有差异，比如JSONField在Django 3.1之前需要依赖第三方库，而内置JSONField的参数可能有变化；或者BigAutoField的默认主键设置方式。

• 解决：对照你使用的Django版本的官方文档，确认字段和参数的用法是否符合当前版本要求，必要时升级到稳定版本或者调整模型定义

如果能把具体的TypeError错误信息贴出来（比如错误栈里的具体提示），能更精准地定位问题哦！

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