Django使用post_save信号触发邮件失败求助（Postmarker配置）

咱们一步步来拆解这个问题，从你给出的代码里已经能发现几个明显的坑，再结合Django信号和邮件配置的常见问题，逐个梳理：

1. 字段名拼写错误（直接导致信号函数中断） #

看你的signal.py里的winner_dict，你写了"Reseller Contact: ", winner.reseller_contact，但你的Winner模型里对应的字段是reseller_code，不是reseller_contact！这会触发AttributeError，整个信号函数直接报错终止，邮件根本发不出去。赶紧把这个字段名改成winner.reseller_code。

2. 信号未正确注册（信号函数根本没被触发） #

Django的信号需要确保在App启动时被加载，如果你只是在signal.py里写了post_save.connect(...)，但没让Django加载这个文件，信号是不会生效的。解决方法：

• 在你的App的apps.py里重写ready方法导入信号：

  from django.apps import AppConfig
  
  class YourAppConfig(AppConfig):
      default_auto_field = 'django.db.models.BigAutoField'
      name = 'your_app_name'
  
      def ready(self):
          import your_app_name.signals
  

• 然后在App的__init__.py里添加：

  default_app_config = 'your_app_name.apps.YourAppConfig'
  

这样才能保证信号在App启动时被正确连接。

3. winner_dict格式错误（模板渲染失败） #

你当前的winner_dict是一个列表（用逗号分隔的元素），但render_to_string需要的是字典（键值对）。正确的写法应该是：

winner_dict = {
    "name": winner.name,
    "email": winner.email,
    "telephone": winner.telephone,
    "postal_code": winner.postal_code,
    "reseller_code": winner.reseller_code,  # 已修正字段名
    "company_name": winner.company_name,
    "company_telephone": winner.company_telephone,
}

然后在winner.html模板里用{{ name }}、{{ email }}这样的变量渲染，标签逻辑放在模板里更规范。

4. 邮件发送参数错误（HTML邮件无法正确显示） #

你用render_to_string生成的是HTML内容，但send_mail的第二个参数message是纯文本内容，HTML内容需要通过html_message参数传递。正确调用方式：

send_mail(
    subject=subject,
    message="请查看邮件的HTML版本",  # 纯文本降级内容
    from_email=from_email,
    recipient_list=recipients_list,
    html_message=message  # 这里传递HTML内容
)

如果不传html_message，收件人看到的会是一堆HTML代码，甚至可能被邮件服务商过滤。

5. Postmarker邮件配置是否正确 #

既然用Postmarker作为邮件后端，要确保settings.py配置无误：

EMAIL_BACKEND = 'postmarker.django.EmailBackend'
POSTMARK = {
    'TOKEN': '你的Postmarker API令牌',
    'TEST_MODE': False,  # 生产环境需设为False
    'VERIFY_SSL': True,
}
DEFAULT_FROM_EMAIL = '已验证的发件邮箱@example.com'  # 必须是Postmarker后台验证过的邮箱
DEFAULT_RECIPIENT_LIST = ['收件人1@example.com', '收件人2@example.com']

还要确认API令牌有效，发件邮箱已完成Postmarker的验证流程。

6. 缺少异常捕获（无法定位隐藏错误） #

信号函数里如果出错，Django默认不会在控制台输出详细信息，建议加异常捕获方便排查：

from django.core.mail import send_mail, BadHeaderError
import logging

logger = logging.getLogger(__name__)

def send_winner_info(sender, instance, created, **kwargs):
    if not created:
        return
    try:
        winner = instance
        winner_dict = {
            "name": winner.name,
            "email": winner.email,
            "telephone": winner.telephone,
            "postal_code": winner.postal_code,
            "reseller_code": winner.reseller_code,
            "company_name": winner.company_name,
            "company_telephone": winner.company_telephone,
        }
        message = render_to_string('mails/winner.html', winner_dict)
        subject = "Giveaway Winner Information"
        from_email = settings.DEFAULT_FROM_EMAIL
        recipients_list = settings.DEFAULT_RECIPIENT_LIST
        
        send_mail(
            subject=subject,
            message="Please view the HTML version of this email.",
            from_email=from_email,
            recipient_list=recipients_list,
            html_message=message
        )
        logger.info(f"成功为获奖者 {winner.email} 发送邮件")
    except BadHeaderError:
        logger.error(f"发送邮件时发现无效头部信息（获奖者：{winner.email}）")
    except Exception as e:
        logger.error(f"为获奖者 {winner.email} 发送邮件失败：{str(e)}")

查看Django日志就能看到具体错误原因。

7. 确认created参数是否为True #

有时候创建Winner时，可能用了update_or_create、save(force_update=True)等方式，导致created为False，邮件逻辑不会执行。可以在信号函数开头加日志确认：

def send_winner_info(sender, instance, created, **kwargs):
    logger.info(f"信号触发，created状态：{created}，获奖者：{instance.email}")
    if created:
        # 邮件逻辑

按照上面的步骤逐一排查，应该能解决问题。

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