应用使用AegisImplicitMail通过465端口发邮件无法嵌入图片求助

我之前在项目里也碰到过一模一样的情况：用System.Net.Mail走587端口发嵌入式图片完全正常，但切换到465端口用AegisImplicitMail时，图片就死活显示不出来。结合你的代码和我踩过的坑，给你几个具体的解决方向和代码示例：

核心差异：AegisImplicitMail与System.Net.Mail的嵌入式资源处理 #

System.Net.Mail会自动帮我们处理部分附件的Disposition类型，但AegisImplicitMail需要手动配置几个关键参数，否则嵌入式图片会被当作普通附件处理，或者无法被HTML内容正确引用。

1. 显式设置附件的Disposition类型和媒体类型 #

创建附件时，不仅要设置ContentId，还要指定图片的MIME媒体类型，并把ContentDisposition明确标记为Inline：

// 假设ChartDayImg是图片文件路径或字节流
var inlineChart = new AiAttachment(ChartDayImg, "image/jpeg"); // PNG图片用"image/png"
string contentID = "inlineChartExplicit";
inlineChart.ContentId = contentID;
// 关键步骤：标记为嵌入式附件
inlineChart.ContentDisposition.DispositionType = DispositionTypeNames.Inline;

2. 确保HTML内容正确引用ContentId #

邮件的HTML正文里，图片的src必须严格对应cid:你的ContentId，注意大小写完全一致，不能有拼写错误：

mailMessage.Body = $"<html><body>每日报表图表：<br><img src=\"cid:{contentID}\"></body></html>";
mailMessage.IsBodyHtml = true;

3. 完整的465端口发送示例代码 #

结合你的业务逻辑，完整的AegisImplicitMail实现应该是这样的：

if (SettingDao.GetSMTPPort() == 465) {
    // 初始化嵌入式图片附件
    var inlineChartExplicit = new AiAttachment(ChartDayImg, "image/jpeg");
    string contentID = "inlineChartExplicit";
    inlineChartExplicit.ContentId = contentID;
    inlineChartExplicit.ContentDisposition.DispositionType = DispositionTypeNames.Inline;

    // 构建邮件
    var mail = new AiMailMessage();
    mail.From = new AiMailAddress("你的发件邮箱");
    mail.To.Add(new AiMailAddress("收件人邮箱"));
    mail.Subject = "带嵌入式图表的报告";
    mail.Body = $"<html><body>您好，以下是今日数据图表：<br><img src=\"cid:{contentID}\"></body></html>";
    mail.IsBodyHtml = true;
    mail.Attachments.Add(inlineChartExplicit);

    // 配置465端口的SMTP客户端（465默认是SSL直连，enableSsl设为true）
    var smtp = new AiSmtpClient("你的SMTP服务器地址", 465, true);
    smtp.Credentials = new System.Net.NetworkCredential("SMTP用户名", "SMTP密码");

    try {
        smtp.Send(mail);
        Console.WriteLine("邮件发送成功");
    } catch (Exception ex) {
        Console.WriteLine($"发送失败：{ex.Message}");
        // 这里可以添加日志记录等异常处理逻辑
    }
}

额外排查点 #

• 检查AegisImplicitMail版本：旧版本可能存在ContentId解析的bug，建议更新到最新稳定版
• 测试不同邮件客户端：有些企业邮箱或客户端会默认屏蔽嵌入式图片，需要手动开启显示
• 确认SMTP服务器配置：465端口要求SSL加密，确保AiSmtpClient的enableSsl参数为true，且服务器支持该端口的SSL连接

内容的提问来源于stack exchange，提问作者hieuvt