Ruby应用联系表单提交后未收到Gmail邮件求助

1. 验证Gmail账户的SMTP权限配置 #

Gmail对SMTP访问有严格限制，需完成以下检查：

• 若开启了两步验证，必须使用应用专用密码替代普通登录密码：进入Google账户设置→安全→应用专用密码，选择邮件应用与对应设备，生成后替换ENV['GMAIL_PASSWORD']的值
• 未开启两步验证的账户，需开启「不太安全的应用访问」（注意该选项可能已逐步被Google淘汰，优先推荐应用专用密码）
• 确认ENV['GMAIL_USERNAME']是完整的Gmail邮箱地址（格式如xxx@gmail.com）

2. 确认环境变量正确加载 #

确保开发环境能读取到正确的邮箱和密码：

• 打开Rails控制台，执行puts ENV['GMAIL_USERNAME']和puts ENV['GMAIL_PASSWORD']，检查输出是否与实际信息一致
• 若使用dotenv管理环境变量，确认.env文件在项目根目录，且变量名拼写无错误，未被.gitignore排除

3. 查看Rails邮件发送日志 #

提交表单后，终端会输出邮件发送的详细日志：

• 查找是否存在Net::SMTPAuthenticationError等认证失败、连接错误的提示
• 若日志显示邮件已成功发送，说明问题不在Rails端，需检查邮箱接收设置

4. 检查邮件视图完整性 #

ContactMailer需要对应视图文件才能生成有效邮件：

• 确认app/views/contact_mailer/目录下存在contact_email.html.erb和/或contact_email.text.erb
• 缺少视图会导致邮件格式无效，可能被Gmail拦截，或发送失败但Rails无报错

5. 检查邮箱的垃圾邮件与归档文件夹 #

很多情况下邮件会被Gmail自动归类：

• 查看「垃圾邮件」文件夹
• 切换到「所有邮件」视图，确认邮件未被归档或过滤到其他标签

6. 优化SMTP配置参数 #

可尝试调整配置提升兼容性：

config.action_mailer.smtp_settings = {
  address: 'smtp.gmail.com',
  port: 587,
  user_name: ENV['GMAIL_USERNAME'],
  password: ENV['GMAIL_PASSWORD'],
  authentication: 'plain',
  enable_starttls_auto: true,
  openssl_verify_mode: 'none' # 仅开发环境临时使用，生产环境不建议
}

同时确保default from的邮箱与user_name一致，降低被反垃圾系统拦截的概率

7. 手动测试邮件发送 #

在Rails控制台直接调用邮件发送方法，排除控制器参数问题：

ContactMailer.contact_email("测试姓名", "test@example.com", "123456789", ["famille"], "测试消息").deliver_now

观察控制台输出是否有错误，同时检查邮箱是否收到测试邮件

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