S3 PreSigned URL发送邮件时被换行截断致无法使用

根因分析 #

你猜的没错，这确实是RFC2822邮件传输规范导致的——协议要求邮件内容每行长度不能超过78个字符（头部除外），传输过程中邮件服务器或客户端会自动给超长的URL插入换行符，直接破坏URL的完整性。Jinja2的|safe过滤器只是防止模板转义特殊字符，根本解决不了传输层的换行截断问题。

可行解决方案 #

1. 对URL做引用可打印编码 #

给预签名URL单独做引用可打印编码，传输层就不会主动截断，客户端收到后会自动解码还原完整URL。
修改代码示例：

import quopri
import boto3

# 生成S3预签名URL
s3 = boto3.client('s3')
presigned_url = s3.generate_presigned_url(
    'get_object',
    Params={'Bucket': 'your-bucket', 'Key': 'your-file-key'},
    ExpiresIn=3600
)
# 对URL做引用可打印编码
encoded_url = quopri.encodestring(presigned_url.encode('utf-8')).decode('utf-8')

# 把encoded_url传入Jinja2模板渲染

Jinja2模板里直接使用编码后的URL：

<a href="{{ encoded_url }}">点击下载文件</a>

2. 正确配置MIME多部分邮件 #

如果发送的是HTML邮件，必须用MIME多部分结构封装内容，避免客户端把HTML当成纯文本处理，同时MIME框架会自动处理超长内容的传输编码。
修改邮件发送部分代码：

from email.mime.multipart import MIMEMultipart
from email.mime.text import MIMEText
import smtplib

# 创建多部分邮件对象
msg = MIMEMultipart('alternative')
msg['Subject'] = "文件下载链接"
msg['From'] = "sender@example.com"
msg['To'] = "recipient@example.com"

# 纯文本备用内容（可选，兼容不支持HTML的客户端）
plain_text = f"请复制以下链接到浏览器打开：{presigned_url}"
# HTML内容直接用原始预签名URL
html_content = your_jinja_template.render(presigned_url=presigned_url)

# 添加邮件内容部分
msg.attach(MIMEText(plain_text, 'plain'))
msg.attach(MIMEText(html_content, 'html'))

# 发送邮件
with smtplib.SMTP('smtp.example.com', 587) as server:
    server.starttls()
    server.login("sender@example.com", "your-password")
    server.send_message(msg)

3. 应急临时办法（不推荐） #

如果暂时没法修改代码，收到邮件后可以手动删除URL中的换行符，把分段的URL拼接成完整的再使用，但这只能作为临时 workaround，不能解决根本问题。

验证方式 #

发送测试邮件后，在Outlook中通过「文件>信息>属性>Internet标题」查看邮件原始源码，确认URL没有被插入原始换行符，或者换行符是引用可打印编码的=0D=0A（客户端会自动解析）。

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