Django PasswordResetView密码重置跳转后未收到邮件问题求解

问题根源及解决方案 #

1. 优先排查反用户枚举安全机制问题

Django密码重置功能默认做了反用户枚举的安全处理：**无论输入的邮箱是否对应系统内存在的已激活用户，都会直接跳转到重置提交成功页，仅当邮箱对应有效用户时才会触发邮件发送。先确认你测试时输入的邮箱是系统中已注册用户绑定的有效邮箱。

2. 修复命名空间下URL匹配问题

你的密码重置相关URL定义在profile命名空间下，PasswordResetView默认生成邮件内重置链接时，会尝试匹配全局无命名空间的password_reset_confirm路径，找不到对应路径会导致邮件生成失败，需要修改password_reset路径的配置，补充url_name参数指定带命名空间的确认路径：

path('password_reset/', auth_views.PasswordResetView.as_view(
    success_url=reverse_lazy('profile:password_reset_done'),
    url_name='profile:password_reset_confirm'
), name='password_reset'),

3. 可选：自定义邮件模板（参数修改不生效时使用）

如果修改参数后仍然无法生成正确的链接，可以自定义密码重置邮件模板，手动指定带命名空间的路径：

1. 在templates/registration/目录下新建password_reset_email.html，内容示例：

{% autoescape off %}
请点击以下链接重置你的账号密码：
{{ protocol }}://{{ domain }}{% url 'profile:password_reset_confirm' uidb64=uid token=token %}
如果点击无效，请复制链接到浏览器地址栏访问。
{% endautoescape %}

2. 在PasswordResetView配置中补充模板路径参数：

path('password_reset/', auth_views.PasswordResetView.as_view(
    success_url=reverse_lazy('profile:password_reset_done'),
    url_name='profile:password_reset_confirm',
    email_template_name='registration/password_reset_email.html'
), name='password_reset'),

4. 配置细节修正

你的settings.py中EMAIL_PORT配置为字符串类型，需要修改为整数类型，避免偶发的端口连接异常：

EMAIL_PORT = 587 # 去掉引号改为整数

补充排查

如果以上配置都正确仍未收到邮件，请到邮箱的垃圾邮件、推广邮件分类中查找，Gmail经常会将系统自动发送的重置邮件归类到上述目录。

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