Django Allauth无法发送验证邮件问题排查求助

我来一步步帮你排查这个Django Allauth邮件验证收不到的问题——这种情况在搭配SMTP配置时太常见了，咱们从最基础的环节开始排查：

先把邮件后端临时切换到控制台模式，跳过SMTP直接看邮件内容能不能生成：
修改settings.py里的EMAIL_BACKEND：

EMAIL_BACKEND = "django.core.mail.backends.console.EmailBackend"

然后重启服务，重新注册账号。如果在runserver的终端里能看到完整的验证邮件内容（包括收件人、验证链接），说明Allauth的触发逻辑没问题，问题出在SMTP配置或者邮件服务商那边；如果终端里啥都没有，那得检查是不是有自定义代码打断了账号创建的邮件发送流程。

你只提到了EMAIL_BACKEND，但SMTP需要完整的配置才能工作，举个常用的QQ邮箱配置例子，你要对应自己的邮箱服务商调整：

EMAIL_HOST = 'smtp.qq.com'  # 替换成你的邮箱服务商SMTP地址，比如Gmail是smtp.gmail.com
EMAIL_PORT = 587  # TLS端口，SSL的话用465，对应要开EMAIL_USE_SSL = True
EMAIL_USE_TLS = True
EMAIL_HOST_USER = 'your-qq-email@qq.com'  # 你的发件邮箱账号
EMAIL_HOST_PASSWORD = 'your-authorization-code'  # 注意：这里是邮箱的SMTP授权码，不是登录密码！
DEFAULT_FROM_EMAIL = EMAIL_HOST_USER  # 发件人显示地址，建议和发件账号一致

重点提醒：几乎所有主流邮箱（QQ、Gmail、163等）都需要先开启SMTP服务，然后生成专门的授权码作为EMAIL_HOST_PASSWORD，直接用登录密码会导致认证失败。

跳过Allauth，用Django自带的工具单独测试SMTP是否能正常发信，这样能快速定位是Allauth的问题还是邮件后端的问题：
打开Django shell（执行python manage.py shell），输入以下代码：

from django.core.mail import send_mail
send_mail(
    '测试邮件主题',
    '这是一封测试邮件',
    '你的发件邮箱@xxx.com',
    ['你的收件邮箱@xxx.com'],
    fail_silently=False,
)

• 如果执行时报错，比如SMTPAuthenticationError（认证失败）、TimeoutError（连接超时），直接根据错误信息调整配置；
• 如果没报错但收不到邮件，那大概率是邮件被收件方的垃圾邮件过滤系统拦截了。

虽然你说大部分是默认，但还是确认下这几个点：

• ACCOUNT_EMAIL_SUBJECT_PREFIX：有没有设置奇怪的前缀（比如带特殊符号），导致邮件被识别为垃圾邮件？默认是空的，一般没问题；
• 有没有自定义ACCOUNT_ADAPTER？如果重写了send_confirmation_mail方法，可能不小心注释掉了邮件发送的逻辑；
• ACCOUNT_EMAIL_VERIFICATION确实设为了"mandatory"，这个你已经确认过，但可以再核对一遍。

• 本地开发时，runserver的终端会输出所有Django的运行日志，仔细看看有没有SMTP相关的错误提示，这些提示是定位问题的关键；
• 如果是生产环境，检查Django的日志文件（比如django.log），搜索email或smtp相关的条目，找报错信息。

• 先检查收件邮箱的垃圾邮件、广告邮件文件夹，很多验证邮件会被误判；
• 确认注册时输入的收件邮箱地址没有拼写错误；
• 换一个不同服务商的邮箱测试（比如从企业邮箱换成QQ邮箱），排除收件方邮箱服务商的拦截规则。

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