Django后台登录报错：has_module_perms()需2个参数却传入3个

从你提供的错误回溯和代码来看，这个问题的根源很明确：某个认证后端的has_module_perms方法参数定义不符合Django的要求。Django在调用这个方法时会传递3个参数（self, user, app_label），但你的后端里这个方法只接受2个参数，导致了类型错误。

下面是具体的排查和解决步骤：

1. 检查自定义认证后端的方法签名 #

如果你在users应用中编写了自定义的认证后端（比如backends.py文件），请检查其中的has_module_perms方法。正确的方法签名应该是：

def has_module_perms(self, user, app_label):
    # 你的权限判断逻辑
    # 示例：返回用户是否有该模块的权限
    return user.is_active and user.is_staff

如果你的方法写成了def has_module_perms(self, app_label):（缺少user参数），就会触发你遇到的错误。修正参数即可解决。

2. 确认settings.py中的认证后端配置 #

打开项目的settings.py，找到AUTHENTICATION_BACKENDS配置项：

• 如果你没有自定义认证后端，确保配置是默认的Django模型后端：

  AUTHENTICATION_BACKENDS = [
      'django.contrib.auth.backends.ModelBackend',
  ]
  

• 如果你添加了自定义后端，确认该后端的所有权限相关方法（has_perm、has_module_perms）都符合Django的参数规范，都需要接受user作为第二个参数。

3. 验证自定义User模型的配置 #

因为你继承了AbstractUser自定义了User模型，确保settings.py中已经正确设置：

AUTH_USER_MODEL = 'users.User'

这一步虽然不是直接导致当前错误，但自定义用户模型时必须配置，否则可能引发其他权限相关的连锁问题。

额外提示 #

从你的代码来看，自定义的User模型和视图逻辑本身没有问题，错误完全来自认证后端的方法参数不匹配。按照上面的步骤排查，应该能快速定位并解决问题。

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