Python boto3与AWS SES邮件发送实战指南-代码聚汇网

Python boto3与AWS SES邮件发送实战指南

周传炽·2026-08-25·阅读 23 GEO检测（免费）

Pythonboto3AWS SES

|难度：普通|阅读约 22 分钟

1. 为什么选择Python boto3与AWS SES发送邮件？

在当今的互联网应用中，邮件通知系统几乎是每个项目的标配需求。作为Python开发者，我们有多种发送邮件的方案可选，但AWS SES（Simple Email Service）配合boto3库的组合在可靠性、扩展性和成本效益方面表现尤为突出。

我最初接触这个方案是在处理一个日发送量超过50万封的电商系统时。当时尝试过自建邮件服务器、第三方SMTP服务等多种方案，最终AWS SES以99.9%的送达率和近乎为零的运维成本胜出。特别是当你的应用已经部署在AWS生态中时，SES能与其他服务（如Lambda、SNS）无缝集成，形成完整的通知体系。

与常见的SMTPlib方案相比，boto3+SES的主要优势在于：

送达率保障：AWS自动处理IP信誉、DKIM签名等专业邮件服务才有的功能
弹性扩展：从每天几封到数百万封都能稳定处理，无需担心服务器过载
详细数据统计：通过CloudWatch可以监控发送量、退信率等关键指标
成本优势：每月前62,000封邮件免费，超出部分仅需$0.10/千封

重要提示：使用SES前需要先完成账户的"沙盒环境"验证。新注册的AWS账户默认处于沙盒模式，只能向已验证的邮箱地址发送邮件。生产环境使用需提交申请，通常1-2个工作日可获得审批。

需要模型API调用？免费领10W Token，多模型网关一键接入 Claude、DeepSeek 等主流模型。

2. 环境准备与基础配置

2.1 安装boto3与配置AWS凭证

首先确保Python环境（建议3.6+）已就绪，通过pip安装必要的库：

bash复制pip install boto3

AWS凭证的配置有三种推荐方式，按优先级排序：

AWS CLI配置（推荐）：安装AWS CLI后运行aws configure，按提示输入Access Key和Region
环境变量：在代码运行前设置AWS_ACCESS_KEY_ID和AWS_SECRET_ACCESS_KEY
直接硬编码（仅测试用）：在代码中创建client时传入参数

python复制# 不推荐的生产环境写法 - 仅用于演示
client = boto3.client(
    'ses',
    aws_access_key_id='YOUR_KEY',
    aws_secret_access_key='YOUR_SECRET',
    region_name='us-west-2'
)

2.2 SES服务开通与域名验证

在AWS控制台完成以下关键步骤：

进入SES控制台 → 选择目标区域（如俄勒冈us-west-2）
在"身份管理"中添加要使用的发件域名或邮箱地址
按照指引添加DNS解析记录（包括MX、SPF、DKIM记录）
等待验证状态变为"已验证"

我曾遇到一个典型问题：团队在测试时跳过了域名验证，直接用临时邮箱发送，结果第二天就触发了AWS的发送限制。正确的做法是：

开发阶段：验证几个测试邮箱地址（如team@example.com）
生产环境：必须验证整个域名（如example.com）
紧急情况：可通过支持中心申请临时提升发送限额

3. 发送邮件的四种实战模式

3.1 基础文本邮件发送

最简单的发送示例，适合系统报警等简单通知：

python复制import boto3
from botocore.exceptions import ClientError

def send_email():
    client = boto3.client('ses', region_name='us-west-2')
    
    try:
        response = client.send_email(
            Source='verified_sender@example.com',
            Destination={
                'ToAddresses': ['recipient@example.com'],
                'CcAddresses': ['cc_recipient@example.com'],
                'BccAddresses': ['bcc_recipient@example.com']
            },
            Message={
                'Subject': {'Data': '测试邮件主题'},
                'Body': {
                    'Text': {'Data': '这是一封测试邮件的正文内容...'},
                    'Html': {'Data': '<h1>HTML版本内容</h1><p>可以包含富文本</p>'}
                }
            },
            ReplyToAddresses=['reply_to@example.com']
        )
    except ClientError as e:
        print(e.response['Error']['Message'])
    else:
        print("邮件发送成功，Message ID:", response['MessageId'])

关键参数说明：

Source：必须使用已验证的发送地址
Destination：支持To/Cc/Bcc三种收件人类型
Message：必须包含Subject和Body，Body可同时提供Text和Html版本
返回值中的MessageId可用于后续追踪邮件状态

3.2 带附件的邮件发送

通过SES发送附件需要先将内容转为Base64编码：

python复制import base64
from email.mime.application import MIMEApplication

def send_email_with_attachment():
    client = boto3.client('ses', region_name='us-west-2')
    
    # 构建附件
    with open('report.pdf', 'rb') as f:
        attachment = MIMEApplication(f.read())
        attachment.add_header('Content-Disposition', 'attachment', filename='report.pdf')
    
    try:
        response = client.send_raw_email(
            Source='sender@example.com',
            Destinations=['recipient@example.com'],
            RawMessage={
                'Data': f"""From: sender@example.com
To: recipient@example.com
Subject: 带附件的测试邮件
MIME-Version: 1.0
Content-type: multipart/mixed; boundary="boundary"

--boundary
Content-Type: text/html; charset=utf-8

<html><body><h1>请查收附件</h1></body></html>

--boundary
Content-Type: application/pdf
Content-Disposition: attachment; filename="report.pdf"
Content-Transfer-Encoding: base64

{base64.b64encode(attachment.get_payload(decode=True)).decode('utf-8')}
--boundary--"""
            }
        )
    except ClientError as e:
        print(e.response['Error']['Message'])
    else:
        print("带附件邮件发送成功，Message ID:", response['MessageId'])

实际项目中，我建议使用Python的email库构建完整MIME消息，而不是手动拼接字符串。这样可以避免边界条件错误和编码问题。

3.3 使用模板发送批量邮件

当需要发送大量结构相似的邮件时（如订单确认、密码重置），使用SES模板功能更高效：

python复制def send_templated_email():
    client = boto3.client('ses', region_name='us-west-2')
    
    # 先创建模板（通常只需执行一次）
    try:
        client.create_template(
            Template={
                'TemplateName': 'OrderConfirmation',
                'SubjectPart': '您的订单 {{order_id}} 已确认',
                'HtmlPart': """
                    <h1>感谢您的购买！</h1>
                    <p>订单号：{{order_id}}</p>
                    <p>总金额：{{amount}}</p>
                    <p>预计送达时间：{{delivery_date}}</p>
                """,
                'TextPart': """
                    感谢您的购买！
                    订单号：{{order_id}}
                    总金额：{{amount}}
                    预计送达时间：{{delivery_date}}
                """
            }
        )
    except client.exceptions.AlreadyExistsException:
        pass  # 模板已存在
    
    # 使用模板发送
    try:
        response = client.send_templated_email(
            Source='orders@example.com',
            Destination={'ToAddresses': ['customer@example.com']},
            Template='OrderConfirmation',
            TemplateData='{"order_id":"12345","amount":"$99.99","delivery_date":"2023-12-31"}'
        )
    except ClientError as e:
        print(e.response['Error']['Message'])
    else:
        print("模板邮件发送成功，Message ID:", response['MessageId'])

模板功能的优势在于：

内容与代码分离，方便非技术人员修改邮件样式
支持多语言模板（通过不同模板名区分）
模板可随时更新而不需要重新部署代码

3.4 批量发送与收件人管理

当需要给大量收件人发送相同内容时，应使用批量发送接口：

python复制def send_bulk_emails():
    client = boto3.client('ses', region_name='us-west-2')
    
    # 准备收件人列表（实际项目中建议从数据库读取）
    recipients = [
        {'email': 'user1@example.com', 'name': '张三', 'vars': {'coupon': 'NEWYEAR2023'}},
        {'email': 'user2@example.com', 'name': '李四', 'vars': {'coupon': 'WELCOME10'}}
    ]
    
    # 使用模板发送批量邮件
    for user in recipients:
        try:
            response = client.send_templated_email(
                Source='newsletter@example.com',
                Destination={'ToAddresses': [user['email']]},
                Template='PromotionTemplate',
                TemplateData=json.dumps({
                    'name': user['name'],
                    'coupon_code': user['vars']['coupon']
                })
            )
            print(f"发送成功至 {user['email']}, Message ID: {response['MessageId']}")
        except ClientError as e:
            print(f"发送失败至 {user['email']}: {e.response['Error']['Message']}")
            
    # 更高效的方式是使用SES的批量API（需要提前准备CSV文件）
    # 参见AWS文档中的SendBulkTemplatedEmail API

重要注意事项：

SES对发送速率有限制（默认每秒1封，可申请提升）
批量发送时应添加退订链接以符合反垃圾邮件法规
建议使用SQS队列实现异步发送，避免阻塞主业务流程

4. 生产环境最佳实践

4.1 监控与告警配置

通过CloudWatch监控关键指标：

Send：成功发送数量
Bounce：退信数量
Complaint：投诉数量
Reject：被拒绝数量

配置告警的推荐阈值：

退信率 > 5% 时触发警告
投诉率 > 0.1% 时立即停止发送

Python代码示例：

python复制def setup_ses_alarms():
    cloudwatch = boto3.client('cloudwatch', region_name='us-west-2')
    
    # 创建退信率告警
    cloudwatch.put_metric_alarm(
        AlarmName='High_Bounce_Rate',
        ComparisonOperator='GreaterThanThreshold',
        EvaluationPeriods=1,
        MetricName='Bounce',
        Namespace='AWS/SES',
        Period=300,
        Statistic='Sum',
        Threshold=5,  # 5%
        ActionsEnabled=True,
        AlarmActions=['arn:aws:sns:us-west-2:123456789012:MyAlertsTopic'],
        Dimensions=[{'Name': 'Identity', 'Value': 'example.com'}]
    )

4.2 错误处理与重试机制

完善的错误处理应包含以下逻辑：

python复制def safe_send_email():
    client = boto3.client('ses')
    max_retries = 3
    
    for attempt in range(max_retries):
        try:
            response = client.send_email(...)
            return response
        except client.exceptions.ThrottlingException:
            wait_time = (2 ** attempt) * 0.1  # 指数退避
            time.sleep(wait_time)
            continue
        except client.exceptions.MessageRejected as e:
            print(f"邮件被拒绝: {e}")
            break
        except ClientError as e:
            code = e.response['Error']['Code']
            if code == 'InvalidParameterValue':
                print("参数错误:", e)
            elif code == 'AccessDenied':
                print("权限不足:", e)
            break
    
    print(f"发送失败，已重试{max_retries}次")
    return None

4.3 成本优化技巧

使用SES发送统计：定期检查GetSendStatistics API，识别低效时段
压缩附件：大附件先压缩再发送，减少数据传输量
合并邮件：将多个通知合并为一封邮件发送
利用SNS：对大量订阅者先发到SNS主题，由AWS负责分发
区域选择：不同区域的SES价格略有差异（如us-west-2较便宜）

示例成本计算：

python复制def estimate_cost(num_emails):
    free_tier = 62000
    if num_emails <= free_tier:
        return 0
    return (num_emails - free_tier) / 1000 * 0.10

5. 常见问题排查

5.1 邮件进入垃圾箱问题

可能原因及解决方案：

SPF/DKIM配置不全：
- 确保域名DNS已添加所有要求的TXT记录
- 使用dig TXT example.com命令验证
发送内容触发垃圾邮件规则：
- 避免使用过多感叹号、全大写单词
- 平衡文字与图片比例
- 包含有效的退订链接
IP信誉问题：
- 新IP需要2-4周建立信誉
- 逐步增加发送量，避免突然爆发

5.2 发送限制错误处理

当遇到ThrottlingException时，应采用指数退避策略：

python复制import time
import random

def send_with_backoff():
    client = boto3.client('ses')
    base_delay = 0.1
    max_retries = 5
    
    for attempt in range(max_retries):
        try:
            return client.send_email(...)
        except client.exceptions.ThrottlingException:
            delay = min((2 ** attempt) * base_delay + random.uniform(0, 0.1), 5)
            time.sleep(delay)
    
    raise Exception("Max retries exceeded")

5.3 调试技巧与日志记录

建议的调试流程：

先在SES控制台手动发送测试邮件
使用ses:SendRawEmail权限测试最小可行代码
启用AWS SDK的调试日志：

python复制import logging
import boto3

# 配置boto3日志
logging.basicConfig(level=logging.DEBUG)
logger = logging.getLogger(__name__)

# 创建带日志的客户端
boto3.set_stream_logger('botocore', logging.DEBUG)
client = boto3.client('ses')

try:
    response = client.send_email(...)
    logger.info("发送成功: %s", response)
except ClientError as e:
    logger.error("发送失败: %s", e, exc_info=True)

6. 进阶应用场景

6.1 与Lambda结合实现无服务器邮件系统

典型架构：

前端提交邮件请求到API Gateway
Gateway触发Lambda函数
Lambda调用SES发送邮件

示例Lambda代码：

python复制import json
import boto3

ses = boto3.client('ses')

def lambda_handler(event, context):
    try:
        data = json.loads(event['body'])
        response = ses.send_email(
            Source=data['from'],
            Destination={'ToAddresses': [data['to']]},
            Message={
                'Subject': {'Data': data['subject']},
                'Body': {'Text': {'Data': data['body']}}
            }
        )
        return {
            'statusCode': 200,
            'body': json.dumps({'messageId': response['MessageId']})
        }
    except Exception as e:
        return {
            'statusCode': 500,
            'body': json.dumps({'error': str(e)})
        }

6.2 邮件点击追踪实现

通过S3+SNS+CloudFront实现：

邮件中的链接替换为追踪URL
用户点击后经过CloudFront记录
日志保存到S3并通过Lambda处理

python复制def generate_tracking_link(original_url, campaign_id):
    s3 = boto3.client('s3')
    
    # 生成唯一追踪ID
    tracking_id = str(uuid.uuid4())
    
    # 上传点击记录到S3
    s3.put_object(
        Bucket='email-tracking-bucket',
        Key=f'clicks/{campaign_id}/{tracking_id}.json',
        Body=json.dumps({
            'original_url': original_url,
            'timestamp': int(time.time()),
            'campaign': campaign_id
        })
    )
    
    # 返回追踪链接
    return f"https://track.example.com/{campaign_id}/{tracking_id}"

6.3 邮件接收处理（SES作为接收端）

配置SES接收邮件的流程：

在SES控制台验证接收域名
配置规则集（Rule Set）
将邮件转发到S3或Lambda处理

接收邮件处理Lambda示例：

python复制def process_received_email(event, context):
    s3 = boto3.client('s3')
    
    # 从事件中获取邮件信息
    record = event['Records'][0]['ses']
    message_id = record['mail']['messageId']
    
    # 从S3获取原始邮件
    email_obj = s3.get_object(
        Bucket='received-emails-bucket',
        Key=message_id
    )
    raw_email = email_obj['Body'].read().decode('utf-8')
    
    # 解析邮件内容
    # ...使用email库解析邮件头和正文...
    
    # 业务逻辑处理
    # ...保存到数据库或触发工作流...

7. 安全防护措施

7.1 IAM权限最小化原则

推荐权限策略示例：

json复制{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Effect": "Allow",
            "Action": [
                "ses:SendEmail",
                "ses:SendRawEmail"
            ],
            "Resource": "*",
            "Condition": {
                "StringEquals": {
                    "ses:FromAddress": "noreply@example.com"
                }
            }
        }
    ]
}

7.2 敏感信息保护

处理邮件模板时的安全建议：

不要在模板中硬编码API密钥
使用AWS Parameter Store存储敏感配置
对邮件内容中的用户数据进行脱敏处理

python复制import boto3
from botocore.exceptions import ClientError

def get_sensitive_data(key):
    ssm = boto3.client('ssm')
    try:
        return ssm.get_parameter(
            Name=key,
            WithDecryption=True
        )['Parameter']['Value']
    except ClientError as e:
        print(f"获取参数失败: {e}")
        return None

7.3 反滥用机制

实现发送限制的代码示例：

python复制from datetime import datetime, timedelta
import boto3

dynamodb = boto3.resource('dynamodb')
table = dynamodb.Table('EmailRateLimiting')

def check_rate_limit(user_id):
    now = datetime.utcnow()
    last_hour = now - timedelta(hours=1)
    
    response = table.query(
        KeyConditionExpression='user_id = :uid AND send_time BETWEEN :start AND :end',
        ExpressionAttributeValues={
            ':uid': user_id,
            ':start': last_hour.isoformat(),
            ':end': now.isoformat()
        }
    )
    
    if len(response['Items']) >= 100:  # 每小时上限100封
        raise Exception("Rate limit exceeded")
    
    # 记录本次发送
    table.put_item(Item={
        'user_id': user_id,
        'send_time': now.isoformat(),
        'message_id': '...'
    })
    return True