Django中Python Social Auth自定义后端报错：issubclass()参数必须是类

• 检查类的实际导入结果
  在项目的任意文件（比如settings.py或测试视图）中手动导入自定义后端类，验证其类型和继承关系：

  from myapp.backends import PingIdentityOAuth2
  from social_core.backends.base import BaseAuth
  
  print(type(PingIdentityOAuth2))  # 正常应输出<class 'type'>
  print(issubclass(PingIdentityOAuth2, BaseAuth))  # 正常应输出True
  

  如果这里输出False，说明类定义本身有问题，比如继承写错、循环导入导致类未正确加载，或者误将类实例化后导入。

• 排查AUTHENTICATION_BACKENDS配置
  确保配置的是类的完整字符串路径，而非导入后的类对象，同时检查拼写和路径正确性：

  AUTHENTICATION_BACKENDS = [
      'myapp.backends.PingIdentityOAuth2',  # 注意路径和类名大小写
      'social_core.backends.github.GithubOAuth2',  # 官方类名是GithubOAuth2（小写g）
      'django.contrib.auth.backends.ModelBackend',
  ]
  

• 检查自定义类的定义语法
  确保类定义无缩进错误，且未在类定义后添加实例化代码：

  # 正确示例
  from social_core.backends.oauth import BaseOAuth2
  
  class PingIdentityOAuth2(BaseOAuth2):
      name = 'pingidentity'
      AUTHORIZATION_URL = 'https://your-ping-domain.com/as/authorization.oauth2'
      ACCESS_TOKEN_URL = 'https://your-ping-domain.com/as/token.oauth2'
      # 其他必要配置字段
  

  避免出现类似ping_backend = PingIdentityOAuth2()的代码，这会导致导入的是类实例而非类本身。

• 清除导入缓存
  开发环境中，Django的自动重载可能存在缓存问题，导致旧的类定义未更新。直接重启runserver服务，或手动清除Python的导入缓存（删除项目根目录下的__pycache__文件夹）。

• 验证social_core版本兼容性
  不同版本的social_core可能存在基类继承链的变动，打印BaseOAuth2的方法解析顺序确认：

  from social_core.backends.oauth import BaseOAuth2
  print(BaseOAuth2.__mro__)
  

  确保输出中包含social_core.backends.base.BaseAuth，若缺失则尝试升级或降级到稳定版本（推荐使用4.x系列）。

• 直接调试检查逻辑
  找到social_core/backends/utils.py第35行附近的代码，在issubclass检查前添加打印语句，确认传入的backend是什么：

  # 在utils.py中临时添加调试代码
  print("Backend object:", backend)
  print("Backend type:", type(backend))
  if not issubclass(backend, BaseAuth):
      raise ValueError('Backend must inherit from BaseAuth')
  

  如果输出是字符串，说明类路径未被正确解析；如果是实例，说明配置中传入的是类实例而非类路径。

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