Django自定义用户模型Telegram登录功能失效求助

以下是针对你代码中潜在问题的排查点和修复方案：

1. JSON请求解析错误（核心问题） #

前端authenticateUser函数以JSON格式发送数据，但后端TelegramAuthView使用request.POST.get()获取参数——Django的request.POST仅支持form-data或urlencoded格式，无法直接解析JSON请求体。

修复代码（users/views.py的TelegramAuthView）：

import json
# ...
def post(self, request, *args, **kwargs):
    try:
        # 解析JSON请求体
        data = json.loads(request.body)
        telegram_id = data.get("telegram_id")
        code = data.get("code")
    except json.JSONDecodeError:
        return JsonResponse({"status": "error", "message": "无效的JSON格式"}, status=400)
    
    # 后续原有逻辑不变

2. 前后端状态码匹配错误 #

前端判断登录成功的条件是data.status === 'success'，但后端返回的成功状态是"status": "ok"，导致即使后端验证通过，前端也会触发错误提示。

修复代码（base.html的authenticateUser函数）：

if (data.status === 'ok') {
    alert('登录成功');
} else {
    alert(data.message);
}

3. 空对象访问导致的隐性500错误 #

AuthenticateView中auth_code可能为None（比如会话过期或无匹配记录），直接访问auth_code.telegram_id会抛出AttributeError，导致服务器500错误但前端仅捕获到通用错误。

修复代码（users/views.py的AuthenticateView）：

def post(self, request, *args, **kwargs):
    auth_backend = TelegramAuthBackend()
    auth_code = AuthCode.objects.filter(
        session_id=request.session.session_key, expiry_time__gt=timezone.now()
    ).first()
    
    # 先判断auth_code是否存在，再访问其属性
    if auth_code and auth_code.telegram_id is not None:
        user = auth_backend.authenticate(request, telegram_id=auth_code.telegram_id)
        if user is not None:
            login(request, user, backend='users.backend.TelegramAuthBackend')
            return JsonResponse({"isLoggedIn": True, "message": "Ok."})
    
    # 所有不满足条件的情况统一返回未登录
    return JsonResponse(
        {"isLoggedIn": False, "message": "用户未登录."}
    )

4. Session未初始化导致的会话键为空 #

GenerateTelegramCodeView中request.session.session_key可能为空（Django需要先创建会话才能生成会话键），导致AuthCode无法关联到当前用户会话。

修复代码（users/views.py的GenerateTelegramCodeView）：

def get(self, request, *args, **kwargs):
    # 强制初始化会话
    if not request.session.session_key:
        request.session.create()
    expiry_time = timezone.now() + timezone.timedelta(minutes=5)
    new_code = AuthCode.objects.create(
        session_id=request.session.session_key, expiry_time=expiry_time
    )
    return JsonResponse({"code": str(new_code.code)})

5. 认证后端缺少get_user方法 #

Django认证后端必须实现get_user方法，否则登录后无法正确持久化用户会话。

修复代码（users/backend.py）：

class TelegramAuthBackend(BaseBackend):
    def authenticate(self, request, telegram_id=None):
        logger.debug(f"Trying to authenticate user with telegram_id={telegram_id}")
        UserModel = get_user_model()
        try:
            user = UserModel.objects.get(telegram_id=telegram_id, is_active=True)
            logger.debug("User found and is active")
            return user
        except UserModel.DoesNotExist:
            logger.debug("User not found")
            return None
    
    # 新增get_user方法
    def get_user(self, user_id):
        UserModel = get_user_model()
        try:
            return UserModel.objects.get(pk=user_id)
        except UserModel.DoesNotExist:
            return None

6. 日志调试配置 #

在settings.py中开启DEBUG模式并配置日志，便于追踪认证流程中的问题：

DEBUG = True

LOGGING = {
    'version': 1,
    'disable_existing_loggers': False,
    'handlers': {
        'console': {
            'class': 'logging.StreamHandler',
        },
    },
    'loggers': {
        'users': {
            'handlers': ['console'],
            'level': 'DEBUG',
            'propagate': True,
        },
    },
}

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