Flask-Mail无运行报错但密码重置邮件未送达问题排查

以下是按优先级排序的问题点和修复方案，全部对应你贴出的代码：

1. Gmail SMTP 配置不符合当前平台规则 #

这是90%同类问题的根因：

• 你填的smtp.googlemail.com是旧版SMTP地址，现在统一替换为smtp.gmail.com，旧地址部分网络环境下会被静默拦截，不抛报错。
• Gmail从2022年起就禁止用账号原始密码登录第三方SMTP服务，你配置里的MAIL_PASSWORD不能填Gmail登录密码：先给对应Gmail账号开启两步验证，再在谷歌账号安全中心生成16位的应用专用密码，把这个值填入MAIL_PASSWORD对应的环境变量。
• 发件人地址必须和SMTP认证账号完全一致：你在send_password_reset_email函数里硬编码了sender为ssaitlib123@gmail.com，如果这个地址和MAIL_USERNAME配置的账号、MAIL_DEFAULT_SENDER配置的发件人不一致，会被Gmail直接拒收，不要硬编码发件人，直接读配置项即可。

2. 环境变量加载失效 #

• 你所有的邮箱敏感配置都是从环境变量读取的，本地开发如果没正确加载.env文件，会导致MAIL_USERNAME、MAIL_PASSWORD、MAIL_SENDER三个值为空，Flask-Mail在非debug模式下会直接吞掉配置缺失的错误，走正常重定向逻辑。临时在视图里打印这三个配置项确认值不为空即可排查。

3. 代码逻辑bug #

• 你在重置密码的路由里写的表单校验逻辑有错误：

  # 错误写法，少了括号，判断方法对象是否存在，永远返回真值
  if form.validate_on_submit:
  

  正确写法是if form.validate_on_submit():，你现在的逻辑哪怕是GET请求访问重置链接，也会直接走到改密码、flash提示、重定向的逻辑，这也是你提到那两行代码无错执行的原因，和邮件发送失败是两个独立问题，一并修复即可。

4. 缺少异常捕获看不到真实报错 #

• 默认情况下Flask-Mail的发送错误在debug=False时会被框架吞掉，给发送逻辑加异常捕获就能看到具体失败原因：

  import smtplib
  
  def send_password_reset_email(user):
      token = user.get_reset_password_token()
      msg = Message(
          'Запит на зміну паролю',
          sender=app.config['MAIL_DEFAULT_SENDER'],
          recipients=[user.email]
      )
      msg.body = f"""
          Для того,щоб змінити свій пароль,натисніть на наступне посилання:
          {url_for('reset_password', token=token, _external=True)}
          Якщо ви не запитували зміну паролю,протсо забийте на це повідомлення
          """
      try:
          mail.send(msg)
      except smtplib.SMTPException as e:
          # 生产环境可以换成日志记录，不要直接打印
          print(f"邮件发送失败，错误详情：{str(e)}")
  

5. 其他容易忽略的点 #

• 显式补充配置app.config['MAIL_USE_SSL'] = False，避免不同版本Flask-Mail默认值不一致，导致587端口TLS连接失败。
• 测试阶段打开app.config['MAIL_DEBUG'] = True，控制台会打印完整的SMTP交互日志，能快速定位是连接阶段失败还是发送阶段被拒收。
• 先检查收件箱的垃圾邮件文件夹，新Gmail账号发送的外语内容邮件，大概率会被反垃圾规则拦截到垃圾箱。
• 排查时先确认你提交的邮箱地址和数据库里存储的用户邮箱完全一致，没有多余空格、大小写差异，你现在的逻辑不管邮箱是否存在都会重定向到登录页（这个逻辑本身是对的，防止邮箱枚举），所以不要靠页面跳转判断是否真的查到了对应用户。

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