Python 使用 SMTP 网关发送 MMS 多媒体消息教程

4. 完整代码示例

以下是一个完整的 Python 类，封装了发送 MMS 的逻辑。它支持自定义运营商、文件路径及 MIME 类型。

import smtplib
import os
from email.mime.base import MIMEBase
from email.mime.multipart import MIMEMultipart
from email.mime.text import MIMEText
from email import encoders
from typing import Tuple, Optional

# 运营商网关配置映射
PROVIDERS = {
    "verizon": {"sms": "vtext.com", "mms": "vtext.com"},
    "tmobile": {"sms": "tmomail.net", "mms": "tmomail.net"},
    "att": {"sms": "txt.att.net", "mms": "mms.att.net"},
    "sprint": {"sms": "messaging.sprintpcs.com", "mms": "messaging.sprintpcs.com"},
}

class MMSSender:
    def __init__(self, sender_email: str, password: str, smtp_server: str = "smtp.gmail.com", port: int = 465):
        self.sender_email = sender_email
        self.password = password
        self.smtp_server = smtp_server
        self.port = port

    def send_mms(self, number: str, message: str, file_path: str, provider: str, 
                 mime_maintype: str = "image", mime_subtype: str = "jpeg",
                 subject: str = "Sent using Python MMS") -> bool:
        """
        发送 MMS 消息
        
        Args:
            number: 手机号码
            message: 消息正文
            file_path: 本地文件路径
            provider: 运营商标识 (如 'verizon', 'tmobile')
            mime_maintype: 主类型 (如 'image', 'application')
            mime_subtype: 子类型 (如 'jpeg', 'pdf')
            subject: 邮件主题
            
        Returns:
            bool: 发送是否成功
        """
        try:
            # 1. 构建收件人地址
            if provider not in PROVIDERS:
                raise ValueError(f"Unsupported provider: {provider}")
            
            # 优先使用 MMS 网关，若不存在则回退到 SMS 网关
            gateway_domain = PROVIDERS[provider].get("mms") or PROVIDERS[provider].get("sms")
            receiver_email = f"{number}@{gateway_domain}"

            # 2. 创建 multipart 消息对象
            msg = MIMEMultipart()
            msg["Subject"] = subject
            msg["From"] = self.sender_email
            msg["To"] = receiver_email

            # 3. 添加文本部分
            text_part = MIMEText(message, "plain")
            msg.attach(text_part)

            # 4. 处理附件
            if os.path.exists(file_path):
                with open(file_path, "rb") as attachment:
                    part = MIMEBase(mime_maintype, mime_subtype)
                    part.set_payload(attachment.read())
                    encoders.encode_base64(part)
                    
                    # 设置文件名
                    filename = os.path.basename(file_path)
                    part.add_header(
                        "Content-Disposition",
                        f"attachment; filename=\"{filename}\""
                    )
                    msg.attach(part)
            else:
                print(f"Warning: File not found at {file_path}")

            # 5. 连接 SMTP 服务器并发送
            server = smtplib.SMTP_SSL(self.smtp_server, self.port)
            server.login(self.sender_email, self.password)
            server.sendmail(self.sender_email, receiver_email, msg.as_string())
            server.quit()
            return True

        except Exception as e:
            print(f"Error sending MMS: {e}")
            return False

# 使用示例
if __name__ == "__main__":
    # 请替换为你的真实凭证
    SENDER_EMAIL = "[email protected]"
    SENDER_PASSWORD = "your_app_password"
    PHONE_NUMBER = "1234567890"
    FILE_PATH = "./photo.jpg"
    
    sender = MMSSender(SENDER_EMAIL, SENDER_PASSWORD)
    success = sender.send_mms(
        number=PHONE_NUMBER,
        message="Hello! This is an MMS sent via Python.",
        file_path=FILE_PATH,
        provider="tmobile",
        mime_maintype="image",
        mime_subtype="jpeg"
    )
    
    if success:
        print("MMS sent successfully.")
    else:
        print("Failed to send MMS.")

5. 关键细节说明

5.1 MIME 类型选择

• 图片: image/jpeg, image/png, image/gif
• 文档: application/pdf, application/msword
• 视频: video/mp4 (注意大小限制，运营商通常限制在 300KB-1MB 之间)

5.2 文件大小限制

运营商对 MMS 的大小有限制。如果文件过大，可能会被丢弃或导致发送失败。建议在发送前检查文件大小，必要时进行压缩。

5.3 安全最佳实践

• 不要硬编码密码: 使用环境变量存储敏感信息。
• 使用 App Password: 开启两步验证后，生成应用专用密码，避免泄露主密码。
• 错误处理: 捕获 SMTP 异常，区分网络错误、认证错误或权限错误。

6. 常见问题排查

1. 发送失败但无报错: 可能是运营商拦截了未知号码。尝试先给自己发送测试。
2. 收不到消息: 确认手机号是否正确，以及该号码是否已开通数据服务。
3. 附件未显示: 检查 Content-Disposition 头是否正确设置，确保 MIME 类型匹配。
4. Gmail 被阻止: Google 可能会认为这是垃圾邮件。建议先在 Gmail 网页端发送测试，确认未被标记。

7. 总结

利用 Python 结合 SMTP 协议和运营商网关，可以低成本地实现 MMS 发送功能。这种方法适合用于内部通知、验证码发送或简单的多媒体提醒场景。开发者需注意不同运营商的差异性，并在生产环境中做好鉴权和安全防护。