Heroku部署Sinatra应用通过SendGrid发邮件出现550及403错误如何解决？

问题排查及解决方法 #

1. SMTP认证配置错误（核心原因） #

SendGrid在2020年之后就已经废弃了普通账号密码的SMTP认证方式，现有规则为：

• SMTP用户名固定为字符串 apikey，不是Heroku自动生成的SENDGRID_USERNAME环境变量值
• SMTP密码为你在SendGrid后台生成的、持有邮件发送权限的API密钥
  你当前代码直接读取Heroku默认生成的SENDGRID_USERNAME和SENDGRID_PASSWORD，不符合最新的认证规则，直接触发550报错。

2. SendGrid后台403权限错误 #

该问题由Heroku与SendGrid的账号关联异常导致，按以下步骤修复：

• 先运行Heroku CLI命令heroku addons:open sendgrid尝试直接跳转后台
• 若仍然报错，先解绑现有SendGrid插件再重新绑定，操作前注意备份现有发件人配置
• 绑定完成后重新在SendGrid后台生成邮件发送权限的API密钥，配置到Heroku环境变量中，变量名可自定义为SENDGRID_API_KEY

3. 发件人字段配置不合规 #

你当前代码直接将用户提交的邮箱作为发件人地址，而SendGrid要求所有发件人地址必须经过身份验证，未验证的第三方发件人地址会直接触发550报错。
你需要调整邮件字段配置：

• from字段固定填写你已经在SendGrid验证通过的发件人地址
• 用户的联系邮箱填写到reply_to字段，这样回复邮件时会直接发送到用户邮箱

修复后参考代码 #

post '/contact' do
 configure_options
 Pony.mail(
    :from => 'noreply@mydomain.com', # 替换为你已验证的SendGrid发件人地址
    :reply_to => [params[:name], "<", params[:email], ">"].join,
    :to => 'hi@mydomain.com',
    :subject =>  ["Opt-in via /contact: ", params[:name]].join,
    :body => [params[:name], params[:email]].join(": ")
  )
  redirect '/'
end

def configure_options
  Pony.options = {
    :via => :smtp,
    :via_options => {
      :address              => 'smtp.sendgrid.net',
      :port                 => '587',
      :domain               => 'heroku.com',
      :user_name            => 'apikey', # 固定为该字符串
      :password             => ENV['SENDGRID_API_KEY'], # 替换为你配置的API密钥环境变量
      :authentication       => :plain,
      :enable_starttls_auto => true
    }
  }
end

额外校验步骤 #

部署后可在Heroku日志中查看SMTP请求的详细报错，确认环境变量是否正常读取，若仍有问题可先在本地用相同配置测试邮件发送功能，排除Heroku环境配置问题。

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