Replit与Mailgun：生产环境邮件发送问题排查

核心结论 #

Replit本身不区分开发/生产环境密钥，但环境变量的配置方式、Mailgun自身的密钥类型差异，是导致部署后失效的常见原因。

具体排查与解决步骤 #

• 检查Replit环境变量配置
  打开Replit项目左侧的「Secrets」（锁形图标），确认Mailgun相关的密钥（如MAILGUN_API_KEY）、域名（MAILGUN_DOMAIN）已正确添加，且变量名与代码中调用的完全一致（注意大小写、下划线）。Replit的Secrets变量会同时作用于开发预览和生产部署，无需单独配置生产环境密钥。

  注意：不要依赖本地的.env文件，Replit部署时不会自动读取该文件，必须通过Secrets管理环境变量。

• 确认Mailgun密钥类型
  Mailgun本身区分测试密钥（Test API Key）和生产密钥（Live API Key）：

  • 测试密钥仅能发送到Mailgun后台添加的测试邮箱，生产环境使用测试密钥发送非测试邮箱会直接失败；
  • 确保Replit Secrets中配置的是Live API Key，且你的Mailgun域名已完成DNS验证，账号具备生产发送权限。

• 调试变量加载情况
  在代码中添加简单的调试代码（避免泄露密钥），验证环境变量是否被正确读取：

  # 以Python为例，其他语言逻辑类似
  import os
  print("MAILGUN_API_KEY exists:", os.getenv("MAILGUN_API_KEY") is not None)
  

  部署后查看生产日志，若输出为False，说明环境变量未正确加载，需检查Secrets中的变量名拼写。

• 根据日志错误定位问题
  结合你提供的日志截图，对应常见错误：

  • 401 Unauthorized：密钥无效或域名未验证；
  • 403 Forbidden：使用测试密钥发送非测试邮箱，或账号发送权限受限；
  • 网络超时：确认Replit网络可访问https://api.mailgun.net（默认无限制，若有特殊网络配置需调整）。

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