Django REST Framework JWT认证无有效账户错误排查

该错误触发条件只有两类：一是authenticate()认证函数未查询到匹配的有效用户，二是匹配到的用户is_active状态为假。结合贴出的代码，最高概率的诱因有3个：

• 自定义User模型重写is_active字段时错误添加null=True属性，导致字段出现三值逻辑（True/False/None），只要任意用户该字段值为None，就会被判定为非激活账号
• 安装了django-allauth但未正确配置认证后端，或开启了强制邮箱验证，导致认证流程被拦截
• 代码中定义的DJANGO_APPS列表未正确拼接进INSTALLED_APPS，或AUTH_USER_MODEL配置存在占位符未替换，导致认证逻辑未使用自定义用户模型

1. 修复is_active字段定义 #

Django官方明确要求is_active为非空布尔字段，三值逻辑会直接干扰状态判断，将自定义User模型中的is_active字段修改为：

# 移除null=True属性
is_active = models.BooleanField(default=True, blank=True)

执行以下命令生成并应用迁移，迁移过程中如果提示输入默认值，输入1（即True）即可：

python manage.py makemigrations
python manage.py migrate

2. 补全认证相关配置 #

首先确认INSTALLED_APPS正确引入Django内置的auth模块，必须将定义的DJANGO_APPS拼接在INSTALLED_APPS最前面：

# 修正后的INSTALLED_APPS开头
INSTALLED_APPS = DJANGO_APPS + [
    # 原有的第三方app、自定义app配置
]

然后在settings.py中添加认证后端配置，避免第三方认证包覆盖默认逻辑，开发环境可直接关闭allauth的强制邮箱验证：

AUTHENTICATION_BACKENDS = [
    'django.contrib.auth.backends.ModelBackend',
    'allauth.account.auth_backends.AuthenticationBackend',
]
# 开发环境关闭邮箱验证，生产环境按需调整
ACCOUNT_EMAIL_VERIFICATION = 'none'

确认AUTH_USER_MODEL配置为真实路径，如果存放User模型的app叫authapp，配置应为：

AUTH_USER_MODEL = 'authapp.User'
# 不要保留my_app_name这类占位符

3. 校验账号真实有效性 #

不要通过可视化工具判断数据库值，直接进入Django shell执行校验，排除密码哈希异常、字段值隐式转换问题：

python manage.py shell

在shell交互界面执行以下代码，替换成实际测试的账号密码：

from authapp.models import User
user = User.objects.get(username="测试用的用户名")
# 确认输出为True <class 'bool'>，不能是None
print("激活状态：", user.is_active, type(user.is_active))
# 确认输出为True，返回False说明密码存储错误，直接重置
print("密码校验：", user.check_password("测试用的密码"))

# 如果密码校验失败，执行以下代码重置
# user.set_password("正确密码")
# user.save()

4. 接口测试 #

重启Django服务后，替换以下命令中的真实账号密码测试，建议显式指定Content-Type头避免参数解析异常：

curl -X POST -H "Content-Type: application/json" -d '{"username":"真实用户名","password":"真实密码"}' http://127.0.0.1:8000/api/token/

定义的UserSerializer中声明了refreshToken字段，但User模型中不存在该字段，后续使用该序列化器做用户返回时会抛出字段不存在的错误，记得同步清理。

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