django-rest-auth迁移至dj-rest-auth时如何解决JWT字段不兼容问题

不需要改动前端现有对接逻辑，也不需要降级依赖，仅在后端响应层做字段映射即可解决接口不兼容问题，具体操作如下：

• 核心实现思路：保留dj-rest-auth + SimpleJWT的全部官方鉴权逻辑，仅修改登录接口的响应输出字段，对齐老版本token字段的返回要求

自定义兼容版JWT响应序列化器 #

在项目的序列化器模块中新增类，继承dj-rest-auth默认的JWT响应序列化器，重写输出逻辑实现字段映射：

# 示例路径：your_project/accounts/serializers.py
from dj_rest_auth.jwt_auth import JWTSerializer

class LegacyCompatibleJWTSerializer(JWTSerializer):
    def to_representation(self, instance):
        # 先拿到官方序列化器生成的完整响应数据
        response_data = super().to_representation(instance)
        # 把原有新接口的access_token值，映射到老接口要求的token字段
        response_data["token"] = response_data.get("access_token")
        # 若需要完全对齐老接口、移除新增的access_token字段，打开下方注释即可
        # del response_data["access_token"]
        return response_data

配置指定使用自定义序列化器 #

在项目的settings.py中，添加dj-rest-auth的序列化器配置，将JWT响应的序列化器替换为上面自定义的兼容版本：

# settings.py
REST_AUTH_SERIALIZERS = {
    # 保持原有登录序列化器不变，仅替换JWT响应序列化器
    'JWT_SERIALIZER': 'your_project.accounts.serializers.LegacyCompatibleJWTSerializer',
}

可选替代方案 #

如果不想修改原有序列化逻辑，可以编写轻量响应中间件，精准拦截登录接口的响应报文，做同样的字段复制映射即可。但这种方式会额外增加一次HTTP响应处理流程，耦合度比序列化器方案高，仅适合有特殊自定义需求的场景。

注意事项 #

• 该改动仅调整登录接口的返回字段名，不改变JWT token本身的签发、校验、过期规则，鉴权链路和官方实现完全一致，无稳定性风险
• 后续前端团队完成字段适配后，可以随时移除兼容逻辑，不需要回滚已完成的Django、依赖升级操作
• 可以在响应中同时保留token和access_token两个字段，实现新旧接口的平滑过渡，不需要等待前端排期即可先完成后端升级

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