MimeKit项目中实现HTML邮件内联图片签名的方法

2025-07-06 11:44:02作者：董宙帆

在邮件开发中，经常需要在HTML邮件正文中嵌入图片作为签名或其他视觉元素。使用MimeKit库可以方便地实现这一功能，但需要注意一些细节才能确保图片正确显示。

基本实现原理

MimeKit通过LinkedResources集合和Content-ID引用机制来实现HTML邮件中的内联图片。核心步骤如下：

创建MimeMessage对象并设置基本信息
使用BodyBuilder构建邮件正文
为图片生成唯一的Content-ID
在HTML中通过cid:引用图片
将图片添加到LinkedResources并设置Content-ID
构建最终邮件内容

常见问题与解决方案

在实现过程中，开发者可能会遇到图片无法显示的问题。最常见的原因是HTML标记中的语法错误，特别是属性值的引号不匹配。

例如，在原始代码中：

var toAdd = $"<br><img src=\"cid:{contentId}\" alt=\"{signatureFile}>";

缺少了alt属性的结束引号，导致HTML解析失败，图片无法显示。

正确的写法应该是：

var toAdd = $"<br><img src=\"cid:{contentId}\" alt=\"{signatureFile}\">";

完整实现示例

以下是使用MimeKit实现HTML邮件内联图片的完整代码示例：

public async Task SendEmailWithInlineImageAsync(string to, string subject, string bodyHtml)
{
    // 图片文件路径
    var signatureFile = "Assets/signature.png";
    
    var message = new MimeMessage();
    message.From.Add(new MailboxAddress("发件人名称", "sender@example.com"));
    message.To.Add(new MailboxAddress("收件人名称", to));
    message.Subject = subject;

    // 生成图片的Content-ID
    var contentId = MimeUtils.GenerateMessageId();
    
    // 构建HTML内容，引用图片
    var builder = new BodyBuilder();
    builder.HtmlBody = $@"
        <html>
            <body>
                {bodyHtml}
                <div style='margin-top: 20px;'>
                    <img src='cid:{contentId}' alt='公司签名'>
                </div>
            </body>
        </html>";
    
    // 添加图片资源并设置Content-ID
    var imageResource = builder.LinkedResources.Add(signatureFile);
    imageResource.ContentId = contentId;
    
    // 设置邮件正文
    message.Body = builder.ToMessageBody();

    // 发送邮件
    using (var client = new SmtpClient())
    {
        await client.ConnectAsync("smtp.example.com", 587, SecureSocketOptions.StartTls);
        await client.AuthenticateAsync("username", "password");
        await client.SendAsync(message);
        await client.DisconnectAsync(true);
    }
}