Django配置SMTP实现密码重置时链接发送异常的问题咨询

问题核心根源 #

你遇到的「重置链接只发到SMTP配置的发件人账号、用户输入的注册邮箱收不到邮件」的现象，基本来自两类诱因：开发阶段的临时代码残留、Gmail SMTP服务的反垃圾规则拦截，可按以下步骤逐一排查修复：

• 第一优先级：排查遗留的临时代码
  • 翻找密码重置流程的自定义代码：绝大多数人在本地开发阶段，为了反复测试功能不对外发垃圾邮件，会重写PasswordResetForm的send_mail方法，强制把收件人列表设置为自己的测试邮箱（也就是你现在配置里的EMAIL_HOST_USER）。如果部署上线时没把这段临时代码删掉，就会出现所有用户提交的邮箱都被无视、所有重置邮件全发到发件人账号的问题。要明确：Django自带的默认密码重置逻辑，会自动把邮件发给用户提交的、匹配到的已注册账号，只要没有手动改这段核心逻辑，绝对不会出现收件人偏移。
  • 检查项目封装的全局邮件发送工具：如果项目里统一封装了发信函数，要确认有没有在开发阶段加过“DEBUG模式下强制把所有邮件重定向到测试邮箱”的判断逻辑，上线时有没有把这个调试开关关掉。
• 第二优先级：验证代码层的真实投递参数
  • 在密码重置邮件的最终发送节点加临时日志，打印真正传给SMTP服务器的收件人列表、发件人地址，确认代码层传的收件人是不是用户输入的注册邮箱。如果日志显示代码传的参数完全正确，但邮件没到用户邮箱，问题就出在SMTP服务侧的规则拦截。
  • 补全Django缺失的邮件基础配置，避免因为发件人不匹配被SMTP拦截，参考配置片段：

  # 将默认发件人、服务器告警收件人和SMTP认证账号保持一致，避免域名校验失败
  DEFAULT_FROM_EMAIL = EMAIL_HOST_USER
  SERVER_EMAIL = EMAIL_HOST_USER
  

• 第三优先级：排查Gmail SMTP的侧规则
  • Gmail的SMTP服务有严格的反垃圾校验：如果发信域名没有配置对应的SPF/DKIM验证记录、或者收件人和当前认证的Gmail账号没有过往会话记录，Gmail会直接把邮件退信到发件人收件箱，视觉上就和“系统把重置链接错发到了发件人账号”的表现完全一致。
  • 检查Gmail账号后台的自动密送、转发规则，确认有没有开启“所有外发邮件自动密送到当前账号”的配置。如果开了这个规则，你给用户发的邮件本来应该同时存在两个副本：一个投递到用户邮箱，一个存在于你的发件人收件箱。如果用户反馈完全收不到邮件，就说明邮件已经在Gmail侧被拦截退信，要么给发信域名补全DNS验证记录，要么换用支持自定义发信域名的企业SMTP服务，才能实现正常投递。

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