Lettre库通过SMTP发送Gmail邮件的完整指南

2025-07-05 00:51:46作者：翟萌耘Ralph

前言

在现代软件开发中，邮件发送功能是许多应用程序的重要组成部分。Rust生态中的Lettre库提供了一个强大而灵活的邮件发送解决方案。本文将详细介绍如何使用Lettre库通过Gmail的SMTP服务器发送电子邮件，特别是针对Gmail安全策略变更后的最新配置方法。

Gmail SMTP认证的变化

Google近年来逐步加强了其SMTP服务的安全要求，取消了"低安全性应用"选项。这意味着传统的仅使用用户名和密码的认证方式不再可行。现在，开发者需要使用以下两种方式之一：

OAuth2认证：更安全但实现较复杂
应用专用密码：两步验证账户的简化方案

本文将重点介绍第二种方法，因为它实现起来相对简单且能满足大多数开发需求。

配置Gmail账户

1. 启用两步验证

首先，您需要在Google账户中启用两步验证：

登录您的Google账户
导航到安全设置
找到"两步验证"选项并启用它

2. 创建应用专用密码

启用两步验证后，您可以创建应用专用密码：

在Google账户的"安全"部分找到"应用密码"
选择"邮件"作为应用类型
选择设备类型（可以选"其他设备"）
生成密码并妥善保存

这个16位字符的密码将替代您的常规密码用于SMTP认证。

使用Lettre发送邮件

基本配置

以下是使用Lettre通过Gmail SMTP发送邮件的基本代码结构：

use lettre::{transport::smtp::authentication::Credentials, Message, SmtpTransport};
use lettre::transport::smtp::client::Tls;
use lettre::message::header::ContentType;

fn main() {
    // 使用应用专用密码创建凭证
    let creds = Credentials::new(
        "your.email@gmail.com".to_owned(),
        "your-app-specific-password".to_owned(),
    );

    // 建立SMTP传输
    let mailer = SmtpTransport::starttls_relay("smtp.gmail.com")
        .unwrap()
        .credentials(creds)
        .port(587)
        .build();

    // 发送测试邮件
    send_email("测试邮件内容".to_string(), mailer);
}

fn send_email(html_body: String, smtp: SmtpTransport) {
    let email = Message::builder()
        .from("发件人名称 <your.email@gmail.com>".parse().unwrap())
        .to("收件人名称 <recipient@example.com>".parse().unwrap())
        .subject("邮件主题")
        .header(ContentType::TEXT_HTML)
        .body(html_body)
        .unwrap();

    match smtp.send(&email) {
        Ok(_) => println!("邮件发送成功!"),
        Err(e) => eprintln!("邮件发送失败: {:?}", e),
    }
}

高级功能

多部分邮件

Lettre支持创建包含纯文本和HTML版本的多部分邮件：

use lettre::message::{MultiPart, SinglePart};

let email = Message::builder()
    .from("发件人 <your.email@gmail.com>".parse().unwrap())
    .to("收件人 <recipient@example.com>".parse().unwrap())
    .subject("多部分邮件示例")
    .multipart(
        MultiPart::alternative()
            .singlepart(
                SinglePart::builder()
                    .header(ContentType::TEXT_PLAIN)
                    .body("纯文本内容".to_string()),
            )
            .singlepart(
                SinglePart::builder()
                    .header(ContentType::TEXT_HTML)
                    .body("<h1>HTML内容</h1>".to_string()),
            ),
    )
    .unwrap();

异步发送

对于异步应用程序，可以使用AsyncSmtpTransport：

use lettre::{AsyncSmtpTransport, Tokio1Executor};
use lettre::transport::smtp::authentication::Credentials;

#[tokio::main]
async fn main() -> Result<(), Box<dyn std::error::Error>> {
    let creds = Credentials::new(
        "your.email@gmail.com".to_owned(),
        "your-app-specific-password".to_owned(),
    );

    let mailer = AsyncSmtpTransport::<Tokio1Executor>::starttls_relay("smtp.gmail.com")?
        .credentials(creds)
        .build();

    // 异步发送邮件...
    Ok(())
}