Django中如何正确附加S3存储桶文件到邮件？解决路径单斜杠错误

我之前也碰到过类似的问题，你现在遇到两个核心问题：一是attach_file()方法不能直接处理S3的HTTP URL，二是MEDIA_ROOT的配置错误导致生成的URL出现单个斜杠的异常格式。下面一步步给你解决：

1. 先修正settings.py中的媒体配置错误 #

MEDIA_ROOT是Django用来指定本地媒体文件存储路径的配置，当你使用S3作为存储后端时，它不应该设置成远程URL，而是本地的一个目录（即使你不用本地存储，这个配置也需要保留正确格式）。另外，你需要正确设置MEDIA_URL来生成合法的S3媒体链接：

import os
BASE_DIR = os.path.dirname(os.path.dirname(os.path.abspath(__file__)))

# 修正MEDIA_ROOT为本地路径
MEDIA_ROOT = os.path.join(BASE_DIR, 'media')
# 正确设置MEDIA_URL为S3的媒体资源前缀
MEDIA_URL = f'https://{AWS_S3_CUSTOM_DOMAIN}/media/'

# 保留其他S3配置不变
AWS_DEFAULT_ACL = 'public-read'
AWS_S3_CUSTOM_DOMAIN = '%s.s3.amazonaws.com' % AWS_STORAGE_BUCKET_NAME
AWS_S3_OBJECT_PARAMETERS = {
    'CacheControl': 'max-age=86400',
}
DEFAULT_FILE_STORAGE = 'sme.storage_backends.MediaStorage'

这个修正会解决URL中出现单个斜杠https:/的问题，同时让Django生成合法的S3媒体链接。

2. 正确将S3文件附加到邮件 #

email.attach_file()方法的设计是读取本地文件系统中的文件，它无法直接处理远程HTTP URL。我们需要通过Django的存储API获取S3文件的内容，然后用email.attach()方法来附加，推荐两种方案：

方案一：内存中直接处理（推荐，适合中小型文件） #

利用Django FileField提供的open()方法直接读取S3文件内容，不需要下载到本地：

from django.core.mail import EmailMessage

# 获取你的Standard实例
standard = Standard.objects.get(name="你的标准名称")

# 创建邮件对象
email = EmailMessage(
    "邮件主题",
    "邮件正文内容",
    "发件人邮箱@example.com",
    ["收件人邮箱@example.com"],
)

# 打开S3文件并附加到邮件
with standard.download.open() as s3_file:
    # 参数分别是：文件名、文件内容、MIME类型
    email.attach(
        standard.download.name,
        s3_file.read(),
        standard.download.content_type
    )

# 发送邮件
email.send()

方案二：临时下载到本地（适合大文件） #

如果文件过大，内存处理压力大，可以临时下载到本地临时文件，附加后再删除：

import tempfile
import os
from django.core.mail import EmailMessage
from django.core.files.storage import default_storage

standard = Standard.objects.get(name="你的标准名称")

email = EmailMessage(
    "邮件主题",
    "邮件正文内容",
    "发件人邮箱@example.com",
    ["收件人邮箱@example.com"],
)

# 临时下载S3文件到本地
with tempfile.NamedTemporaryFile(delete=False) as tmp_file:
    tmp_file.write(default_storage.open(standard.download.name).read())
    tmp_file_path = tmp_file.name

# 附加本地临时文件
email.attach_file(tmp_file_path, mimetype=standard.download.content_type)
email.send()

# 删除临时文件，避免占用空间
os.unlink(tmp_file_path)

为什么原来的代码会报错？ #

你之前用email.attach_file(standard.download.url)，attach_file()会把传入的字符串当作本地文件路径去读取，但standard.download.url是一个HTTP URL（比如https:/bucket-name.s3.amazonaws.com/...），系统自然找不到这个“本地文件”，所以抛出No such file or directory的错误。加上之前MEDIA_ROOT配置错误，导致URL格式异常（单个斜杠），进一步加重了问题。

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