Rails 5本地用Yandex Connect(SMTP)发邮件报SMTP-AUTH密钥缺失错误排查

我来帮你排查几个本地环境常见的问题，都是踩过坑的经验：

• 本地环境变量没配置全或加载失败
  你在Heroku上用环境变量管理凭据没问题，但本地很容易漏设或者没正确加载SMTP的核心参数——除了MAIL_DOMAIN，SMTP_USERNAME（你的Yandex邮箱地址）和SMTP_PASSWORD（这里必须是Yandex的应用专用密码，不是邮箱登录密码）这两个变量必须存在且有值。
  可以打开Rails控制台，输入puts ENV['SMTP_PASSWORD']看看输出是不是空的，如果是空的，检查你的.env文件（或者你用的其他环境变量管理工具），确保这些变量正确配置，并且Rails能读取到。

• SMTP配置不完整
  只设置default_url_options是不够的，你还需要在config/application.rb或者config/environments/development.rb里完整配置SMTP的认证参数。比如：

  config.action_mailer.smtp_settings = {
    address: 'smtp.yandex.ru',
    port: 587,
    domain: ENV['MAIL_DOMAIN'],
    user_name: ENV['SMTP_USERNAME'],
    password: ENV['SMTP_PASSWORD'],
    authentication: 'plain',
    enable_starttls_auto: true
  }
  

  本地开发环境如果单独在development.rb里做了配置，一定要确保这些参数都填对，尤其是password和authentication不能留空。

• Yandex账户的安全限制
  如果你的Yandex账户开了两步验证，那绝对不能用普通的邮箱登录密码作为SMTP密码，必须去Yandex账户的安全设置里生成一个应用专用密码来用。另外还要确认你的账户已经开启了SMTP服务，有些默认是关闭的，需要手动打开。

• 配置文件的优先级冲突
  比如你在development.rb里的配置覆盖了application.rb里的SMTP设置，导致认证参数被清空或者写错了。检查下config/environments/development.rb里有没有关于action_mailer.smtp_settings的代码，确保它和生产环境的配置逻辑一致，核心的认证参数没被遗漏。

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