Django3密码重置功能无报错但未生成发送邮件问题排查

1. 优先排查邮箱存在性逻辑 #

Django 原生PasswordResetView为避免用户邮箱被恶意枚举，默认有静默逻辑：只要表单提交合法，无论输入的邮箱是否存在于用户表中，都会直接跳转到「密码重置邮件已发送」页面，但仅对存在的用户邮箱触发邮件发送。
先测试：在密码重置表单输入已在用户表中注册的有效邮箱，验证是否有邮件生成。

2. 验证SMTP配置有效性 #

直接通过Django Shell测试邮件发送，排除视图层问题：

1. 执行命令进入Shell：python manage.py shell
2. 运行测试代码：

from django.core.mail import send_mail
from django.conf import settings

# 先确认配置读取是否正确
print("发件邮箱：", settings.EMAIL_HOST_USER)
print("发件密码：", settings.EMAIL_HOST_PASSWORD)

# 测试发信
send_mail(
    '调试测试邮件',
    '这是Django测试邮件内容',
    settings.EMAIL_HOST_USER,
    ['你的测试收件邮箱'],
    fail_silently=False,
)

如果测试报错，按以下优先级排查配置：

• Gmail 自2022年起已下线「允许不安全应用」权限，无法直接用账号密码登录SMTP，需先开启谷歌账号两步验证，再生成应用专用密码，填入EMAIL_HOST_PASSWORD配置项
• 确认env变量是否正确读取，避免配置值为空或读取错误
• 本地调试时确认EMAIL_BACKEND没有被误设为django.core.mail.backends.console.EmailBackend（仅输出到控制台不实际发送）

如果Shell测试发信正常，本地调试SMTP服务能收到内容，说明配置无问题，问题出在密码重置视图逻辑。

3. 适配自定义用户模型 #

如果项目使用了自定义用户模型，需确认：

• 用户模型的邮箱字段默认名为email，如果自定义了字段名（如mail、user_email），原生视图无法识别该字段，不会触发发信
  解决方法是自定义重置表单指定查询字段：

# forms.py
from django.contrib.auth.forms import PasswordResetForm
from .models import 你的自定义用户类

class CustomPwResetForm(PasswordResetForm):
    def get_users(self, email):
        return 你的自定义用户类.objects.filter(自定义邮箱字段名__iexact=email)

修改urls.py中视图配置：

path('pw_reset/', auth_views.PasswordResetView.as_view(
    template_name="authacc/pw_reset.html",
    form_class=CustomPwResetForm
), name="reset_password"),

4. 排查第三方组件/信号拦截 #

如果项目引入了权限类第三方组件，或者自定义了邮件发送相关的信号监听，可能会覆写默认密码重置的发信逻辑，可临时注释相关配置后再测试。

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