Rails集成Devise后重置密码邮件未收到问题求助

嘿，我太懂这种控制台显示邮件已处理但就是收不到的挫败感了！咱们一步步拆解排查：

• 先确认基础邮件配置是否正确
  Devise是依赖Rails的Action Mailer发邮件的，所以先去对应环境的配置文件（比如config/environments/development.rb或config/environments/production.rb）检查SMTP参数：

  config.action_mailer.smtp_settings = {
    address: 'smtp.example.com', # 比如Gmail是smtp.gmail.com
    port: 587,
    domain: 'example.com',
    user_name: 'your_email@example.com',
    password: 'your_password_or_app_password',
    authentication: :plain,
    enable_starttls_auto: true
  }
  

  要是用Gmail且开了两步验证，得用应用专用密码而非普通密码，还要确认账号安全设置里没有限制外部应用访问。

• 先测试基础邮件发送功能
  别先死磕Devise，先验证Rails本身能不能发邮件。打开Rails控制台（rails c），运行这段代码：

  ActionMailer::Base.mail(
    from: 'your_sender_email@example.com',
    to: 'your_test_email@example.com',
    subject: 'Test Email',
    body: '如果收到这封邮件，说明基础邮件功能正常！'
  ).deliver_now
  

  要是这封测试邮件也收不到，那问题出在邮件服务配置上，和Devise无关；要是能收到，再往下排查。

• 检查Devise的专属邮件配置
  打开config/initializers/devise.rb，确认两个关键配置：

  • config.mailer_sender：这个地址必须有效，而且最好和SMTP配置里的user_name一致——很多邮件服务商要求发件人和认证地址匹配。
  • 如果你自定义了Devise的Mailer（比如config.mailer = 'CustomDeviseMailer'），检查这个自定义Mailer有没有语法错误，或者覆盖reset_password_instructions方法时逻辑出了问题。

• 别漏看垃圾邮件文件夹
  这是最容易忽略的点！很多测试邮件会被邮箱服务商判定为垃圾邮件，去收件箱的“垃圾邮件”“促销邮件”文件夹里找找，说不定它就在那儿待着呢。

• 开启详细日志抓隐藏错误
  控制台只显示“已处理”但没报错？那开启更详细的邮件日志试试。在对应环境的配置文件里加这两行：

  config.action_mailer.raise_delivery_errors = true
  config.action_mailer.logger = Logger.new(STDOUT)
  

  重启服务器后再试一次重置密码，这时候控制台会输出完整的邮件发送流程，比如连接失败、认证错误这类隐藏问题，能帮你快速定位根源。

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