如何配置Google App Engine弹性环境下Django应用发送注册确认邮件？

太懂你折腾四天的崩溃了！我之前也在GAE弹性环境里踩过Django发邮件的坑，结合django-allauth的场景，给你整理了几个靠谱的配置方案，一步步来应该能解决问题：

一、先搞清楚GAE弹性环境的特殊点 #

和GAE标准环境不一样，弹性环境没法直接用内置的mail API，得靠SMTP或者第三方邮件服务来发邮件，下面两种是最常用的方案：

方案1：用Gmail/Google Workspace邮箱发（适合小流量应用） #

如果你的应用发送邮件量不大（比如每天几百封以内），用自己的Gmail或者Google Workspace邮箱最方便，但要注意现在Gmail必须开两步验证才能用SMTP：

1. 先给你的Gmail账号开启两步验证，然后生成一个应用专用密码（这个密码不是你的邮箱登录密码，专门给应用用的）；如果是Google Workspace邮箱，也建议用应用密码，更安全。
2. 配置Django的settings.py，别硬编码敏感信息！用环境变量来存：
   先在你的app.yaml里加环境变量：

   env_variables:
     EMAIL_HOST_USER: 'my_email_address@gmail.com'
     EMAIL_HOST_PASSWORD: '你的应用专用密码'
     DEFAULT_FROM_EMAIL: '你的应用名 <my_email_address@gmail.com>'
   

   然后在settings.py里读取这些变量：

   import os
   
   # 邮件核心配置
   EMAIL_BACKEND = 'django.core.mail.backends.smtp.EmailBackend'
   EMAIL_HOST = 'smtp.gmail.com'
   EMAIL_PORT = 587
   EMAIL_USE_TLS = True
   EMAIL_HOST_USER = os.environ.get('EMAIL_HOST_USER')
   EMAIL_HOST_PASSWORD = os.environ.get('EMAIL_HOST_PASSWORD')
   DEFAULT_FROM_EMAIL = os.environ.get('DEFAULT_FROM_EMAIL', EMAIL_HOST_USER)
   SERVER_EMAIL = os.environ.get('EMAIL_HOST_USER')  # 用来发系统错误邮件
   
   # django-allauth 相关配置，确保触发邮箱验证
   ACCOUNT_EMAIL_VERIFICATION = 'mandatory'  # 强制验证，按需改成'optional'或者'none'
   ACCOUNT_EMAIL_CONFIRMATION_EXPIRE_DAYS = 3
   ACCOUNT_EMAIL_SUBJECT_PREFIX = '[你的应用名] '
   

方案2：用第三方邮件服务（适合大流量应用） #

如果你的应用要发很多邮件，或者不想受Gmail的限额（每天500封），推荐用SendGrid、Mailgun这类服务，以SendGrid为例：

1. 去SendGrid官网注册，或者在Google Cloud Marketplace里安装，获取你的API密钥。
2. 同样用环境变量存密钥，然后在settings.py里配置：

   import os
   
   EMAIL_BACKEND = 'django.core.mail.backends.smtp.EmailBackend'
   EMAIL_HOST = 'smtp.sendgrid.net'
   EMAIL_PORT = 587
   EMAIL_USE_TLS = True
   EMAIL_HOST_USER = 'apikey'  # 固定填这个，不用改
   EMAIL_HOST_PASSWORD = os.environ.get('SENDGRID_API_KEY')
   DEFAULT_FROM_EMAIL = '你的应用名 <no-reply@你的域名.com>'
   

   记得在app.yaml里加SENDGRID_API_KEY这个环境变量。

方案3：用Google Cloud官方的邮件服务（适合企业级场景） #

如果想用Google自家的企业级邮件服务，需要先启用Cloud Mail Service API，然后用专门的Django后端：

1. 先装依赖：

   pip install django-google-appengine-email
   

2. 在settings.py里配置：

   EMAIL_BACKEND = 'django_gae_email.backends.EmailBackend'
   DEFAULT_FROM_EMAIL = '你的应用名 <no-reply@你的域名.com>'
   

3. 还要去Google Cloud IAM给你的GAE服务账号加mail.send的权限，并且验证你的发送域名，避免邮件被当成垃圾邮件。

二、测试邮件是否能发 #

配置完别着急部署，先测试一下：

1. 本地测试：直接在本地运行Django shell，执行：

   from django.core.mail import send_mail
   send_mail(
       '测试邮件',
       '这是一封测试邮件',
       os.environ.get('EMAIL_HOST_USER'),
       ['你的测试邮箱@example.com'],
       fail_silently=False,
   )
   

2. 部署到GAE后测试：用命令行打开GAE的shell：

   gcloud app shell
   

   然后执行上面的代码，看有没有报错。如果失败，去看GAE的日志：

   gcloud app logs tail -s default
   

   根据日志里的错误信息排查，比如密码错了、SMTP连不上之类的。

三、常见坑排查 #

• SMTP认证失败：检查Gmail的两步验证开了没，应用密码是不是正确；Google Workspace的话，要确认管理员允许SMTP访问。
• 邮件进垃圾邮箱：一定要用已验证的域名发邮件，设置好DKIM、SPF记录；第三方邮件服务一般会帮你处理这些，比自己配置省心。
• GAE弹性环境连不上SMTP：弹性环境默认允许587端口的出站请求，如果你改了防火墙规则，要确保没封这个端口。
• django-allauth不发邮件：检查ACCOUNT_EMAIL_VERIFICATION是不是设成了mandatory或者optional，如果是none的话不会发；另外看Django的日志，有没有邮件发送的错误信息。

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