Django测试中override_settings未生效，如何覆盖SMTP配置？

我之前也踩过这个坑！Django的@override_settings在处理邮件配置时，经常会因为一些容易忽略的细节导致配置没生效，咱们一步步来排查和解决：

1. 检查配置加载的时机是否过早 #

最常见的问题是：你的邮件发送逻辑在测试方法执行前就已经加载了配置（比如模块级别初始化了EmailBackend实例），而@override_settings是在测试运行时才生效的，这时候已经晚了。

错误示例： #

# 模块级别提前初始化了连接，会读取初始配置
from django.core.mail import get_connection

conn = get_connection()

@override_settings(EMAIL_HOST_PASSWORD='sdsds')
def test_email_not_sent():
    # 这里使用的conn还是初始配置的连接，override_settings没生效
    conn.send_messages(...)

修复方案： #

确保在测试方法内部（或者override_settings生效后）再初始化邮件连接：

@override_settings(EMAIL_HOST_PASSWORD='sdsds')
def test_email_not_sent():
    # 测试方法内才加载连接，此时配置已经被覆盖
    from django.core.mail import get_connection
    conn = get_connection()
    # 可以先验证配置是否生效：print(conn.password) 应该输出'sdsds'
    # 执行你的测试逻辑...

或者用上下文管理器更直观地控制作用域：

def test_email_not_sent():
    with override_settings(EMAIL_HOST_PASSWORD='sdsds'):
        from django.core.mail import get_connection
        conn = get_connection()
        # 在这里执行邮件测试

2. 确认是否使用了第三方/自定义邮件Backend #

如果你的项目用了django-anymail这类第三方邮件库，或者自定义了EmailBackend，它们可能不直接使用EMAIL_HOST_PASSWORD这个配置项。比如AnyMail会用ANYMAIL_SENDGRID_API_KEY、ANYMAIL_MAILGUN_API_KEY这类专属配置键，这时候你需要覆盖对应的键，而不是EMAIL_HOST_PASSWORD。

举个例子，如果你用SendGrid：

@override_settings(ANYMAIL_SENDGRID_API_KEY='test-key')
def test_email_not_sent():
    # 测试逻辑...

3. 排查是否有其他配置覆盖源 #

• 检查你的测试专用settings文件（比如settings/test.py）是否硬编码了EMAIL_HOST_PASSWORD，虽然@override_settings优先级更高，但有时候测试框架的加载顺序可能出问题，你可以在测试方法里先打印配置确认：

  from django.conf import settings
  
  @override_settings(EMAIL_HOST_PASSWORD='sdsds')
  def test_email_not_sent():
      print(settings.EMAIL_HOST_PASSWORD)  # 先确认输出是否为'sdsds'
  

• 如果你用了测试类，确保方法级的@override_settings没有被类级的装饰器覆盖（方法级优先级更高，但还是要检查）。

4. 确认测试逻辑真的用到了配置 #

有时候不是配置没覆盖，而是你的邮件发送逻辑根本没从settings取密码！比如硬编码了密码：

错误示例： #

def send_test_email():
    send_mail(
        subject="Test",
        message="Hello",
        from_email="test@example.com",
        recipient_list=["user@example.com"],
        password="hardcoded-password"  # 这里硬编码了，override_settings没用
    )

修复方案： #

让发送逻辑使用settings中的配置，或者通过get_connection获取配置好的连接：

from django.core.mail import send_mail, get_connection

def send_test_email():
    conn = get_connection()  # 自动读取当前settings的配置
    send_mail(
        subject="Test",
        message="Hello",
        from_email="test@example.com",
        recipient_list=["user@example.com"],
        connection=conn
    )

总结 #

先通过打印settings.EMAIL_HOST_PASSWORD确认配置是否真的没覆盖，然后依次排查：

• 配置加载时机是否过早
• 是否用了正确的配置键（尤其是第三方Backend）
• 测试逻辑是否真的依赖settings配置

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