执行Django migrate时遇TypeError: 'staticmethod' object is not callable报错如何解决？

常见原因 #

这个错误几乎都是代码中错误混用@staticmethod和@property（或@cached_property）装饰器导致的。比如在模型类里写出类似这样的代码：

class MyModel(models.Model):
    @property
    @staticmethod
    def some_value():
        return "test"

装饰器顺序颠倒也会触发同样问题，这会让Django的属性机制尝试调用静态方法对象，从而抛出错误。

解决步骤 #

• 排查代码：遍历所有模型类、自定义工具类，找出所有同时使用@staticmethod和@property/@cached_property的方法。
• 修正装饰器使用：
  • 如果方法仅需静态调用，去掉@property装饰器，保留@staticmethod，调用时用MyModel.some_value()。
  • 如果需要作为实例属性访问，去掉@staticmethod，保留@property，调用时用instance.some_value（不带括号）。
• 检查依赖库：如果是第三方库引入的问题，升级对应库到兼容Django4.2的版本，或替换为替代库。
• 重新执行迁移：

  python manage.py makemigrations --empty
  python manage.py migrate
  

  若无未应用的迁移，可直接重新执行migrate命令。

额外检查点 #

• 确认自定义的@cached_property（来自django.utils.functional）未与静态方法混用。
• 检查信号处理器、中间件中的类方法是否存在类似装饰器混用问题。

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