Django邮件模板图片无法显示，仅带域名的完整URL可正常加载

核心问题 #

Django的FileField/ImageField的url属性默认仅返回相对路径，而邮件客户端打开邮件时不会默认以你的站点域名作为相对路径的根路径，因此必须传递带完整域名的绝对路径才能正常加载资源。

缺失配置&修复步骤 #

1. 基础配置校验 #

首先确保项目已配置站点信息：

• 确认settings.py的INSTALLED_APPS中已添加django.contrib.sites
• 在settings.py中新增配置SITE_ID = 1
• 执行python manage.py migrate完成站点表迁移后，在Django admin后台将站点的域名修改为你的线上正式域名（如abc.com）

2. 生成带域名的完整图片URL #

根据发邮件的场景选择对应实现方式：

场景1：视图函数中同步发邮件（有request对象）

直接调用request的build_absolute_uri方法自动拼接域名：

{
    'picture': request.build_absolute_uri(picture.url)
}

场景2：异步任务/无request对象的场景发邮件

调用Django站点框架手动拼接完整路径：

from django.contrib.sites.models import Site

current_site = Site.objects.get_current()
# HTTPS站点将http改为https即可
full_pic_url = f"https://{current_site.domain}{picture.url}"
{
    'picture': full_pic_url
}

调整完成后原有邮件模板的图片引用代码无需修改，直接使用{{picture}}即可正常渲染。

注意事项 #

• 线上环境不要将站点域名配置为localhost、127.0.0.1等本地地址
• HTTPS站点需确保拼接的协议头为https，否则会触发混合内容拦截导致图片加载失败
• 若图片存放在第三方CDN，直接拼接CDN域名作为前缀即可，无需使用站点域名

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