Django+PostgreSQL执行migrate报错：Model实例无主键值不可哈希

我之前在Django+PostgreSQL项目里执行python3 manage.py migrate时也踩过这个坑，这个错误本质是Django处理迁移时，尝试把还没生成主键的模型实例放到哈希集合（比如set）这类需要哈希值的结构里，但无主键的实例无法被哈希，所以抛出了这个异常。下面是几个最常见的原因和对应的解决办法：

1. 模型自定义了依赖主键的 __hash__ 方法 #

• 如果你在某个模型类里重写了__hash__方法，且方法逻辑依赖self.pk或者主键字段，那当模型实例还未保存（没有主键值）时，就会触发这个错误。
• 解决办法：修改__hash__方法，确保在无主键时也能生成有效哈希值，或者直接去掉自定义的__hash__（Django默认会用主键生成哈希，非特殊需求无需自定义）。示例：

  # 错误示例：依赖主键的自定义__hash__
  def __hash__(self):
      return hash(self.pk)
  
  # 修正后：用其他唯一字段或兼容无主键的逻辑
  def __hash__(self):
      return hash((self.unique_username, self.email))
  

2. 迁移文件里存在操作未保存实例的逻辑 #

• 如果你手动修改过迁移文件，或者通过RunPython添加了自定义迁移逻辑，里面若创建了模型实例但未保存，就直接放到set、字典键这类需要哈希的结构里，就会触发错误。
• 解决办法：检查所有迁移文件的RunPython代码块，确保创建的实例先调用.save()生成主键，再进行后续哈希相关操作。示例：

  # 错误示例：未保存实例就加入set
  def forwards(apps, schema_editor):
      MyModel = apps.get_model('myapp', 'MyModel')
      instance = MyModel(name="test_item")
      my_unique_set = {instance}  # 此处报错，因为instance无pk
  
  # 修正后：先保存实例生成主键
  def forwards(apps, schema_editor):
      MyModel = apps.get_model('myapp', 'MyModel')
      instance = MyModel(name="test_item")
      instance.save()
      my_unique_set = {instance}
  

3. 模型主键字段配置不合理 #

• 如果模型的主键字段被修改（比如把AutoField改成UUIDField但未设置默认值），或者主键字段设为可空，迁移时生成的实例可能没有主键值，进而触发错误。
• 解决办法：确保模型的主键字段不可空，且有合理默认值（比如UUIDField设置default=uuid.uuid4），然后重新生成迁移文件执行。示例：

  # 错误示例：主键字段无默认值
  class MyModel(models.Model):
      id = models.UUIDField(primary_key=True)
  
  # 修正后：添加默认值
  import uuid
  class MyModel(models.Model):
      id = models.UUIDField(primary_key=True, default=uuid.uuid4, editable=False)
  

4. 第三方库/自定义信号的逻辑问题 #

• 如果项目使用了第三方模型或者自定义信号（比如pre_save信号），里面可能存在操作未保存实例的哈希相关逻辑，导致迁移时出错。
• 解决办法：暂时禁用第三方库或者信号注册代码，逐步排查是哪个组件引发的问题，再针对性修复。比如先注释掉信号处理函数，执行migrate，若错误消失，就去检查信号逻辑里是否有操作无主键实例的哈希操作。

排查时也可以尝试回滚最近的迁移，再逐步重新应用，定位到具体是哪个迁移文件或模型修改引发的问题，这样更容易找到根源。

内容的提问来源于stack exchange，提问作者Anton.Y