Go go-smtp 怎样重置未完成的发送事务

Go go-smtp 中，重置一封尚未完成的邮件事务直接调用 Client.Reset()。它发送 SMTP 的 RSET，清除当前的发件人、收件人和邮件数据，但保留底层连接；重置成功后，可以在同一个 Client 上重新调用 Mail。不过，已经调用 Data() 并拿到 DataCommand 后，不能把 Reset 当成正在写入正文时的通用取消按钮。

官方地址：https://pkg.go.dev/github.com/emersion/go-smtp

Reset 清除的是事务，不是连接

go-smtp 的 Client.Reset 对应 SMTP 的 RSET 命令。SMTP 规范把它定义为终止当前邮件事务，丢弃已经保存的 sender、recipient 和 mail data，并要求服务端返回 250；它不会因为收到 RSET 就关闭连接。

因此，Reset 适合处理“上一封邮件走到一半，连接还活着，但我不想继续提交这封邮件”的情况。它和 Close、Quit 的职责不同：前者清理事务，后两者处理连接生命周期。

在 MAIL 或 RCPT 阶段出错后调用 Reset

一封邮件的事务通常从 Mail 开始，接着调用一次或多次 Rcpt，最后才进入 Data。如果 Mail 已经成功，而某个收件人被拒绝，当前事务可能还保留着发件人和已经接受的收件人。此时调用 Reset，再重新开始 Mail，可以让下一次发送从干净事务开始。

package main

import (
    "fmt"

    smtp "github.com/emersion/go-smtp"
)

// retryWithReset 展示 RCPT 阶段失败后如何清理事务并重新开始。
func retryWithReset(c *smtp.Client, from, firstTo, nextTo string, message []byte) error {
    // MAIL 成功后，SMTP 事务已经打开；后续错误不能直接复用旧状态。
    if err := c.Mail(from, nil); err != nil {
        return fmt.Errorf("开始邮件事务失败: %w", err)
    }

    // 用一个故意可能失败的收件人模拟 RCPT 阶段的中断。
    if err := c.Rcpt(firstTo, nil); err != nil {
        // Reset 发送 RSET，清掉本次 MAIL/RCPT 状态，但不主动断开连接。
        if resetErr := c.Reset(); resetErr != nil {
            return fmt.Errorf("重置邮件事务失败: %w", resetErr)
        }
    }

    // Reset 成功后，下一封事务必须重新发送 MAIL，而不是只补一个 RCPT。
    if err := c.Mail(from, nil); err != nil {
        return fmt.Errorf("重启邮件事务失败: %w", err)
    }
    if err := c.Rcpt(nextTo, nil); err != nil {
        return fmt.Errorf("添加新收件人失败: %w", err)
    }

    // Data 返回的写入器必须在调用 Client 的其他方法前关闭。
    data, err := c.Data()
    if err != nil {
        return fmt.Errorf("进入 DATA 阶段失败: %w", err)
    }
    if _, err := data.Write(message); err != nil {
        // 写入失败时保留原始错误；连接是否可复用要由上层决定。
        _ = data.Close()
        return fmt.Errorf("写入邮件正文失败: %w", err)
    }
    if err := data.Close(); err != nil {
        return fmt.Errorf("提交邮件正文失败: %w", err)
    }
    return nil
}

这个例子有一个容易忽略的点：调用 Reset 后不能只继续调用 Rcpt。因为事务的 MAIL FROM 和收件人缓冲都已经被清掉，必须重新执行 Mail，然后再添加新的收件人。

进入 DATA 后先处理 DataCommand 边界

Client.Data() 返回的是一个待完成的 DataCommand，底层写入器负责把邮件正文写入 SMTP 的 DATA 对话。官方文档明确要求：调用者应先关闭这个写入器，再调用 Client 的其他方法。原因是此时客户端仍处于正文传输阶段，直接发送 RSET 会破坏命令与响应的同步关系。

如果正文完整写入，调用 data.Close() 会结束 DATA 对话并等待服务端结果，此时这一笔事务已经走向提交，不需要再用 Reset。如果写入过程中连接已经报错，data.Close() 可能也会失败；这时不要循环调用 Reset，应把当前客户端视为不可复用并进入重连流程。

用连接状态决定是 Reset 还是重新 Dial

可以把错误分成两类。第一类是服务端仍然正常响应，只是当前地址或参数让事务无法继续，例如某个 RCPT 被拒绝。这种错误适合记录原始响应，然后调用 Reset，保留连接给下一封邮件。第二类是读写超时、连接被对端关闭或底层网络错误，这说明客户端和服务端的对话状态可能已经不同步；此时发送 RSET 不能保证对方能正确解析，直接关闭并重新 Dial 更稳妥。

func recoverClient(c **smtp.Client, addr string, err error) error {
    // 外层已经判断这是网络层错误，旧连接不再承担后续事务。
    if *c != nil {
        _ = (*c).Close()
    }

    // 重新建立连接并把新客户端交回调用方管理。
    next, dialErr := smtp.Dial(addr)
    if dialErr != nil {
        return fmt.Errorf("重新连接 SMTP 服务失败: %w; 原错误: %v", dialErr, err)
    }
    *c = next
    return nil
}

上面的函数只负责替换连接，不负责重新认证或重放邮件。实际项目中，重新 Dial 后还要按原流程执行 TLS、认证和必要的 Hello，并且只能重放尚未得到成功 DATA 响应的邮件；已经收到服务端成功响应的邮件不能因为客户端重连就盲目重复发送。

Reset、Close 和重新连接怎么选

常见问题

Reset 会不会关闭 go-smtp 的连接？

不会。它发送 RSET 并清除当前邮件事务；关闭连接应使用 Quit 或 Close。

Reset 成功后可以直接调用 Rcpt 吗？

不建议。Reset 清掉了当前事务，下一次发送应先调用 Mail，成功后再调用 Rcpt。

DataCommand 还没关闭时能调用 Client.Reset 吗？

不能把它当成安全的通用做法。先结束 DataCommand；如果底层连接已经失败，直接废弃旧连接并重新建立会话。

什么时候应该保留连接？

只有在服务端仍按 SMTP 协议返回响应、客户端能够确认命令边界完整时，才适合用 Reset 复用连接。

总结

Go go-smtp 的 Client.Reset() 是“清理当前邮件事务”的动作，适合放在 MAIL/RCPT 阶段的可恢复错误之后。进入 DATA 后，优先遵守 DataCommand 的关闭约束；一旦连接状态不确定，就关闭旧客户端并重新建立会话。把事务恢复和连接恢复分开处理，才能避免下一封邮件继承上一封邮件的收件人或落入协议错位。

参考资料：https://pkg.go.dev/github.com/emersion/go-smtp；https://github.com/emersion/go-smtp/blob/master/client.go；https://www.rfc-editor.org/rfc/rfc5321#section-4.1.1.5