Moto模拟AWSSES邮件发送教程

大家好，今天本人给大家带来文章《Moto 模拟 AWS SES 邮件发送教程》，文中内容主要涉及到，如果你对文章方面的知识点感兴趣，那就请各位朋友继续看下去吧~希望能真正帮到你们，谢谢！

本文详解如何用 moto 框架可靠地单元测试 AWS SES 邮件发送逻辑，重点解决因未验证发件邮箱导致的 `MessageRejected` 错误，并提供可运行的完整测试示例。

在使用 moto 模拟 AWS SES（Simple Email Service）进行本地单元测试时，一个常见且容易被忽视的陷阱是：moto 严格遵循 AWS SES 的真实行为——所有发件邮箱地址必须预先验证才能成功发送邮件。这正是你遇到 botocore.errorfactory.MessageRejected: Email address not verified 错误的根本原因：你的代码中使用的 [email protected] 并未在 mock 环境中注册为已验证身份。

✅ 正确做法：先验证，再发送

与真实 AWS SES 一致，moto 要求你显式调用 verify_email_identity() 方法，将发件人邮箱加入“已验证邮箱列表”。否则，send_email() 调用会直接失败，即使整个测试被 @mock_aws 装饰。

以下是修复后的完整、可运行测试代码（兼容 moto ≥ 4.0，使用新版 @mock_aws）：

import os
import boto3
from moto import mock_aws
from moto.ses import ses_backends
from moto.core import DEFAULT_ACCOUNT_ID

import pytest
import pytest_check as ptc

import rbn_lib.comms as comms  # 假设这是你的模块路径

DEFAULT_REGION = "us-east-1"

@pytest.fixture
def aws_credentials():
    """强制设置测试用 AWS 凭据，避免读取真实凭证"""
    os.environ["AWS_ACCESS_KEY_ID"] = "testing"
    os.environ["AWS_SECRET_ACCESS_KEY"] = "testing"
    os.environ["AWS_SECURITY_TOKEN"] = "testing"
    os.environ["AWS_SESSION_TOKEN"] = "testing"
    os.environ["AWS_DEFAULT_REGION"] = DEFAULT_REGION

@mock_aws
@pytest.fixture
def sess(aws_credentials):
    """提供已启用 mock 的 boto3 Session 实例"""
    return boto3.Session()

@mock_aws
def test_send_email(sess):
    to = ["test@test_email.us"]
    subject = "Test"
    body = "Test"
    from_email = "<a class="__cf_email__" data-cfemail="b5c1d0c6c1f5d1dad8d4dcdb9bd6dad8" href="/cdn-cgi/l/email-protection">[email protected]</a>"

    # ✅ 关键步骤：必须先验证发件人邮箱！
    ses_client = sess.client("ses", region_name=DEFAULT_REGION)
    ses_client.verify_email_identity(EmailAddress=from_email)

    # ✅ 然后才能调用被测函数
    comms.send_email(sess, to, subject, body, from_email=from_email)

    # ✅ 断言：从 moto 内部 backend 获取已发送邮件
    ses_backend = ses_backends[DEFAULT_ACCOUNT_ID][DEFAULT_REGION]
    assert len(ses_backend.sent_messages) == 1
    sent_msg = ses_backend.sent_messages[0]

    ptc.equal(sent_msg.subject, subject)
    ptc.equal(sent_msg.body, body)
    ptc.equal(sent_msg.source, from_email)
    ptc.equal(sent_msg.destinations, to)

⚠️ 注意事项与最佳实践

• @mock_aws 必须作用于测试函数或 fixture：确保 sess fixture 和 test_send_email 都被 @mock_aws 装饰，否则 moto 不会拦截 boto3 调用。
• 验证邮箱必须与 send_email(Source=...) 中的 Source 完全一致：包括大小写和前后空格。建议统一使用 .strip() 处理输入。
• 无需手动管理 ses_backends 的生命周期：moto 在 @mock_aws 作用域内自动初始化并隔离 backend 实例，每个测试相互独立。
• 支持批量验证与域名验证：除 verify_email_identity() 外，moto 同样支持 verify_domain_identity(domain)，适用于生产级测试场景。
• 调试技巧：若断言失败，可打印 ses_backend.sent_messages 或检查 ses_backend.email_addresses（已验证邮箱列表）辅助定位问题。

✅ 总结

moto 并非“跳过规则”的简易桩，而是力求行为保真的轻量级服务模拟器。对 SES 而言，“验证发件人”不是可选配置，而是强制前提。只要在测试中补上 verify_email_identity() 这一行，你的邮件发送逻辑就能在完全离线、零网络依赖的环境下稳定通过单元测试——这才是真正可靠、可重复、CI 友好的测试方案。

文中关于的知识介绍，希望对你的学习有所帮助！若是受益匪浅，那就动动鼠标收藏这篇《Moto模拟AWSSES邮件发送教程》文章吧，也可关注golang学习网公众号了解相关技术文章。