Rails Action Mailer本地正常，Heroku生产环境发信失败报内部错误

排查步骤 #

• 优先确认Heroku环境变量配置
  运行heroku config命令检查GMAIL_USERNAME和GMAIL_PASSWORD两个环境变量是否已经正确配置到Heroku平台，本地.env文件不会自动同步到部署环境，遗漏配置会直接导致SMTP认证失败。

• 修正Gmail认证方式
  2022年之后Google已经不再支持普通账号密码登录第三方SMTP服务，需要按要求调整：

  1. 为你的Gmail账号开启两步验证
  2. 在Google账号安全中心生成应用专用密码，将生成的16位专用密码作为GMAIL_PASSWORD的值配置到Heroku，不要使用原账号登录密码
  3. 检查ApplicationMailer中的默认发件人配置，发件人地址必须和你认证用的Gmail地址完全一致，否则会被Google拒发

• 解决请求阻塞无响应问题
  你当前使用的是同步发送方法.deliver，会阻塞当前请求直到邮件发送完成或抛出异常。Heroku平台的路由默认超时时间为30秒，若SMTP连接卡顿、被拒会直接导致请求超时，前端收不到响应。
  把发送代码改成异步发送即可：

# 把原代码
NewUserEmailMailer.notify_user(@user).deliver
# 替换为
NewUserEmailMailer.notify_user(@user).deliver_later

Rails默认自带异步队列，修改后用户保存成功就会立刻返回响应，邮件会放到后台队列异步发送，不会阻塞请求。

• 补充SMTP配置项
  在production.rb的smtp_settings中补充domain配置，避免SMTP服务校验发件人域时拦截：

config.action_mailer.smtp_settings = {
  address: 'smtp.gmail.com',
  port: 587,
  domain: 'art-wall-api.herokuapp.com', # 新增这行
  user_name: ENV['GMAIL_USERNAME'],
  password: ENV['GMAIL_PASSWORD'],
  authentication: 'plain',
  enable_starttls_auto: true
}

• 查看具体报错定位问题
  如果以上调整后仍有问题，执行heroku logs --tail实时查看生产环境日志，触发一次注册操作就能看到具体的错误原因（比如SMTP认证失败、Google账号安全拦截等），可以针对性处理。如果是Google拦截了登录请求，可以进入Gmail账号的安全中心，找到异常登录记录手动放行即可。

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