使用Django GraphQL Auth时passwordReset突变总是超时，求排查帮助

核心排查方向：邮件发送阻塞（最可能原因） #

passwordReset 突变的核心逻辑是生成重置令牌并发送邮件，本地环境通常使用调试邮件后端（不实际发送邮件），而线上环境需要真实调用SMTP服务，这是最容易出现阻塞的环节：

• 验证SMTP配置有效性：检查线上settings.py中的邮件配置（EMAIL_HOST、EMAIL_PORT、EMAIL_HOST_USER、EMAIL_HOST_PASSWORD）是否与服务商要求一致，尤其注意SSL/TLS设置（EMAIL_USE_SSL/EMAIL_USE_TLS）是否正确。
• 测试邮件发送耗时：在服务器上进入Django shell后执行测试脚本，直接调用Django的邮件发送函数，验证是否能快速完成：

from django.core.mail import send_mail
send_mail(
    "测试邮件",
    "测试内容",
    "your-sender-email@example.com",
    ["test-recipient@example.com"],
    fail_silently=False,
)

如果执行超过30秒，说明邮件服务本身存在延迟或网络问题，需联系邮件服务商确认是否限流，或检查服务器出站端口（25/465/587）是否被防火墙封禁。

优化Gunicorn与请求处理逻辑 #

• 临时调整超时阈值：将Gunicorn的超时时间临时调高（如--timeout 60），观察是否能完成passwordReset请求，以此确认是否是邮件发送耗时超过当前超时设置。
• 改用异步处理邮件：同步worker会在发送邮件时阻塞，导致请求超时。推荐将邮件发送任务剥离到异步队列（如Celery），让passwordReset突变仅触发任务、立即返回，不等待邮件发送完成。示例改造：

# 自定义PasswordReset mutation
from graphql_auth import mutations
from celery import shared_task

@shared_task
def send_password_reset_email(email, reset_url):
    from django.core.mail import send_mail
    send_mail(
        "重置你的密码",
        f"点击链接重置密码：{reset_url}",
        "sender@example.com",
        [email],
    )

class CustomPasswordReset(mutations.PasswordReset):
    @classmethod
    def mutate(cls, root, info, **kwargs):
        # 调用父类逻辑生成重置令牌和链接
        result = super().mutate(root, info, **kwargs)
        # 获取用户邮箱，触发异步邮件任务
        email = kwargs.get("email")
        reset_url = info.context.build_absolute_uri(f"/reset-password/{result.token}")
        send_password_reset_email.delay(email, reset_url)
        return result

之后在GraphQL schema中替换原有的PasswordReset mutation即可。

日志与错误捕获 #

• 提升日志级别：在settings.py中开启Django邮件模块的DEBUG日志，捕获发送过程中的细节：

LOGGING = {
    # 保留原有日志配置...
    "handlers": {
        "console": {
            "class": "logging.StreamHandler",
        },
    },
    "loggers": {
        "django.core.mail": {
            "handlers": ["console"],
            "level": "DEBUG",
            "propagate": True,
        },
    },
}

• 手动捕获异常：自定义mutation时添加try-except，强制记录所有异常信息：

class CustomPasswordReset(mutations.PasswordReset):
    @classmethod
    def mutate(cls, root, info, **kwargs):
        try:
            return super().mutate(root, info, **kwargs)
        except Exception as e:
            import logging
            logger = logging.getLogger(__name__)
            logger.error(f"Password reset failed: {str(e)}", exc_info=True)
            raise

其他排查点 #

• 验证依赖版本一致性：确保线上环境的Django、Django GraphQL Auth、graphene-django等依赖版本与本地完全一致，避免版本冲突导致的隐藏阻塞。
• 检查数据库性能：开启数据库慢查询日志，确认passwordReset过程中查询用户的语句是否存在性能问题（如缺少索引）。

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