Django邮件中静态图片无法显示的问题求助

1. 确保静态文件可公开访问 #

• 生产环境：检查settings.py的STATIC_ROOT配置，运行python manage.py collectstatic把静态文件收集到指定目录，再配置Nginx/Apache等Web服务器，让STATIC_URL对应的路径（比如https://yourdomain.com/static/）能直接访问到图片。
• 开发环境：保持DEBUG=True，确保静态文件服务正常，邮件里的图片URL要写完整的http://localhost:8000/static/xxx.png格式。

2. 生成正确的绝对URL #

不要直接依赖{% static %}标签（默认生成相对路径），在视图中结合请求上下文生成完整URL后传给模板：

from django.templatetags.static import static
from django.shortcuts import render

def send_order_email(request):
    # 生成静态图片绝对URL
    logo_url = request.build_absolute_uri(static('img/logo.png'))
    status_img_url = request.build_absolute_uri(static('img/status.png'))
    # 商品若用媒体文件，同理：request.build_absolute_uri(product.image.url)
    
    context = {
        'logo_url': logo_url,
        'status_img_url': status_img_url,
        # 其他订单数据
    }
    
    html_content = render(request, 'mail.html', context).content.decode()
    # 后续发送邮件逻辑...

模板中直接使用变量：

<img src="{{ logo_url }}" alt="站点Logo">
<img src="{{ status_img_url }}" alt="订单状态">

3. 解决邮件客户端屏蔽外部图片问题 #

多数邮箱（Gmail、Outlook）默认阻止外部图片加载，可选两种方案：

• 方案1：引导用户手动显示：在邮件开头加提示，告知用户点击"显示图片"查看完整内容。
• 方案2：嵌入Base64编码图片：把图片转为Base64编码直接嵌入邮件，无需外部请求：

  import base64
  import os
  from django.conf import settings
  
  def img_to_base64(img_static_path):
      img_full_path = os.path.join(settings.STATIC_ROOT, img_static_path)
      with open(img_full_path, 'rb') as f:
          return base64.b64encode(f.read()).decode('utf-8')
  
  # 视图中调用
  logo_base64 = img_to_base64('img/logo.png')
  context['logo_base64'] = logo_base64
  

  模板中使用：

  <img src="data:image/png;base64,{{ logo_base64 }}" alt="站点Logo">
  

  注意：大图片不建议用此方法，会增加邮件体积，部分老旧客户端可能不兼容。

4. 验证渲染后的URL正确性 #

查看渲染后的HTML源码，确认图片src是完整可访问的URL（比如https://yourdomain.com/static/img/logo.png），若地址错误，检查request.build_absolute_uri调用或静态文件配置是否有误。

5. 测试邮件效果 #

用Mailtrap等邮件测试工具查看渲染结果，或发送到个人邮箱，通过浏览器开发者工具检查图片请求的状态码（404说明地址错误，200但不显示则是客户端屏蔽问题）。

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