使用django-allauth时Django邮件测试功能失效问题求助

问题背景 #

使用 Django 5.0.1 搭配 django-allauth 框架，真实SMTP邮件后端配置下，邮件确认功能可正常运行；单独测试Django原生邮件功能（如官方文档示例）时，邮件也能正常收集到mail.outbox中。但测试allauth的注册确认邮件发送功能时，mail.outbox始终为空。本地服务器运行时，注册后能正常收到邮件，测试环境却无法复现该行为。

测试代码 #

class SignupProcessTest(TestCase):

    def setUp(self):
        # 初始化基础表单数据，测试方法中仅覆盖特定字段
        self.data = {"email": "roland.szucs@booknwalk.com",
                     "password1": "ajtoablak1",
                     "newsletter": 1}
    
    def test_confirmEmailSent(self):
        self.client.post(reverse("account_signup"),
                         self.data,
                         secure=True,
                         follow=True)
        # 校验邮件是否发送
        self.assertEqual(len(mail.outbox), 1, f"确认邮件未发送：当前outbox数量为{len(mail.outbox)}")

排查思路 #

• 检查allauth邮件验证配置：确认settings中ACCOUNT_EMAIL_VERIFICATION未设为none（该值会直接跳过邮件发送），同时ACCOUNT_EMAIL_REQUIRED需设为True，否则注册流程可能无需邮箱验证。
• 验证表单提交是否成功：测试中仅调用post请求，未校验注册是否完成。可添加断言检查返回状态码（如self.assertEqual(response.status_code, 200)），或验证用户是否创建成功：self.assertTrue(User.objects.filter(email=self.data["email"]).exists())——若用户未创建，自然不会触发邮件发送。
• 关闭allauth异步邮件发送：部分allauth版本默认异步发送邮件，测试环境下异步任务可能未执行。可在settings中添加ACCOUNT_EMAIL_ASYNC = False强制同步发送，或在测试中手动触发异步任务。
• 确认测试类继承正确性：确保SignupProcessTest继承自django.test.TestCase，而非其他类。只有TestCase会自动将邮件后端替换为locmem.EmailBackend，若使用SimpleTestCase可能不会完成该替换。
• 排查自定义信号/中间件拦截：若项目中存在用户注册相关的自定义信号或中间件，可能修改了allauth的邮件发送逻辑。可临时注释自定义代码后重新测试，确认是否存在拦截。
• 检查表单字段完整性：若settings中ACCOUNT_USERNAME_REQUIRED设为True，注册表单需提交username字段，但测试数据中未包含该字段，会导致表单验证失败、注册流程中断。可在self.data中添加"username": "rolandszucs"后重试。
• 调试邮件后端状态：在测试中打印django.core.mail.get_connection().outbox，部分场景下邮件会存入连接对象的outbox而非全局mail.outbox，以此确认邮件是否被实际调用发送。

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