必须配置 DEFAULT_AUTHENTICATION_CLASSES 为 JWTAuthentication,否则 JWT 认证不生效;仅安装包和添加 APP 不够。需继承 TokenObtainPairView 自定义载荷添加 username、user_id 等非敏感字段,刷新 token 失效常见于误传 access token 或请求格式错误,生产环境须启用 ROTATE_REFRESH_TOKENS 并结合黑名单机制管理生命周期。

直接用 djangorestframework-simplejwt,别自己手写 token 生成和校验逻辑——它已深度适配 DRF 的认证流程,且默认支持刷新、黑名单、自定义载荷等关键能力。
安装与基础配置必须配齐 DEFAULT_AUTHENTICATION_CLASSES
不配这个,JWT 认证压根不会触发。仅装包、加 app 是不够的。
- 运行
pip install djangorestframework-simplejwt - 在
INSTALLED_APPS中添加'rest_framework_simplejwt' - 在
REST_FRAMEWORK配置中明确声明:"DEFAULT_AUTHENTICATION_CLASSES": [ "rest_framework_simplejwt.authentication.JWTAuthentication", ] - 确保视图或视图集没覆盖
authentication_classes,否则会绕过全局配置
TokenObtainPairView 返回的 payload 默认不含用户字段
前端通常需要 user.id 或 user.username 渲染界面,但默认响应体只有 access 和 refresh 字段。
- 继承
TokenObtainPairView,重写get_token()方法,在 token 载荷里手动加字段:class MyTokenObtainPairView(TokenObtainPairView): def get_token(cls, user): token = super().get_token(user) token["username"] = user.username token["user_id"] = user.id return token - 注意:不要往 payload 放敏感信息(如密码哈希、邮箱),JWT 是 Base64 编码,非加密
- 前端拿到 token 后,可直接解析 Base64 第二段(payload)获取这些字段,无需额外请求用户接口
刷新 token 时 TokenRefreshView 报 Token is invalid or expired
常见于开发环境时间不同步、或刷新请求没带 refresh 字段——这个错误不是 JWT 签名失败,而是 refresh token 本身已失效。
立即学习“Python免费学习笔记(深入)”;
- 检查是否误把
accesstoken 当作refresh提交(二者结构不同,refresh 更长) - 确认请求体是 JSON 格式,且含
{"refresh": "xxx..."},不是 query 参数或 form data - 默认 refresh token 有效期为 7 天,若需延长,修改
SIMPLE_JWT["REFRESH_TOKEN_LIFETIME"] - 生产环境务必启用
ROTATE_REFRESH_TOKENS = True,避免单点泄露导致长期风险
JWT 认证真正的复杂点不在签发,而在 token 生命周期管理:什么时候该强制下线?如何处理多设备登录冲突?simplejwt 提供了黑名单机制,但你需要自己决定在登出、改密、拉黑用户时调用 OutstandingToken 和 BlacklistedToken 模型——这部分没有开箱即用的视图,容易被跳过。


















