C#发送HTML邮件模板在Outlook桌面端渲染异常、图片不显示问题求解

问题1：Outlook桌面端仅展示纯文本内容 #

Outlook桌面端默认使用Word作为HTML渲染引擎，且对邮件格式的校验规则更严格，可按以下步骤修复：

• 发送邮件时必须显式设置MailMessage.IsBodyHtml = true，未开启该属性时所有HTML内容都会被客户端识别为纯文本。
• 若同时发送纯文本+HTML的多部分替代邮件，注意添加AlternateView的顺序：优先添加纯文本视图，再添加HTML视图，Outlook会默认选择最后添加的适配格式展示。
• 所有HTML代码必须适配Word渲染规则：
  • 100%使用行内CSS，不要在<style>标签内写全局样式，Outlook会直接忽略头部样式。
  • 所有布局使用嵌套<table>实现，不要使用flex、grid、float等现代CSS布局属性，不要依赖<div>的边距属性，所有间距、宽高都通过<td>的行内style设置。
  • 避免使用自闭合标签，比如把<img/>改为<img></img>、<br/>改为<br></br>，防止解析错误。
• 在HTML头部添加兼容元标签：<meta http-equiv="X-UA-Compatible" content="IE=edge">，强制Outlook使用最高版本渲染模式。

问题2：邮件图片无法显示、被拦截或src属性丢失 #

绝大多数是邮件客户端的反垃圾、反跟踪策略导致的，可按以下优先级选择解决方案：

方案A：使用内嵌CID图片（兼容性最高） #

不要用外链或者base64图片，直接把图片嵌入邮件资源内，C#实现逻辑如下：

1. 把需要使用的图片创建为LinkedResource对象，设置唯一的ContentId值，比如company_logo
2. HTML模板内的img标签写为 <img src="cid:company_logo" alt="企业logo"></img>
3. 将创建好的LinkedResource添加到HTML对应的AlternateView的LinkedResources集合中，不要直接作为普通附件添加，否则会被识别为附件而非内嵌资源。

方案B：使用外链图片的兼容规则 #

如果必须使用外链图片，需满足以下要求：

• 图片URL必须是HTTPS协议，HTTP协议的外链会被所有主流邮件客户端直接拦截。
• 图片URL不要携带动态跟踪参数、跳转参数，Gmail的反垃圾策略会直接抹除携带可疑跟踪参数的图片src属性。
• 所有<img>标签必须添加非空的alt属性，属性值不要包含营销、推广类敏感词，避免被判定为垃圾邮件资源拦截。
• 不要使用base64编码直接写在img的src属性内，Outlook、Gmail均会直接拦截base64格式的图片资源。

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