FluentEmail常见问题根因是NuGet包选错、SMTP配置不匹配、编码未显式设置：必须安装FluentEmail.Smtp而非Core或弃用聚合包；Port与EnableSsl须严格对应（如587配true）；Subject需指定Encoding.UTF8，Body须设isHtml:true以触发UTF-8 MIME头。
FluentEmail 初始化失败、发不出邮件、中文乱码、HTML 不渲染——这些问题基本都卡在三处：NuGet 包装错、SMTP 配置不匹配、Body 和 Subject 编码没显式设。
安装 FluentEmail.Smtp 而不是 FluentEmail 或 FluentEmail.Core
直接 new SmtpSender(...) 报 “类型未找到” 或调用 SendAsync() 时抛 NullReferenceException，90% 是包装错了。
- 必须安装
FluentEmail.Smtp：它会自动拉取FluentEmail.Core，并提供SmtpSender实现 - 别装
FluentEmail（老聚合包，已弃用） - 也别只装
FluentEmail.Core（纯接口+空壳，无发送能力） - 如果要用 SendGrid，得换装
FluentEmail.SendGrid，不能混用
SMTP 配置必须端口、SSL、用户名三者严格对齐
连不上、认证失败、超时，往往不是密码错，而是这三项不匹配。
-
Port = 587→EnableSsl = true（Gmail / Outlook / 多数云邮箱） -
Port = 465→EnableSsl = true（部分企业邮件服务器） -
Port = 25→EnableSsl = false（极少见，且多数被拦截） - 用户名必须是完整邮箱地址，例如
"user@gmail.com"，不是"user" - Gmail 必须用「应用专用密码」，Outlook 必须开启「SMTP 授权」并生成应用密码
HTML 邮件必须显式声明 isHtml: true 且 Subject 指定 UTF-8
中文变问号、CSS 失效、<table> 渲染异常，问题出在两个默认行为上。
-
.Subject("你好")默认走 ASCII 编码 → 改成.Subject("你好", Encoding.UTF8) -
.Body(htmlString)默认当纯文本处理 → 必须写成.Body(htmlString, isHtml: true) -
<meta charset="utf-8">在邮件客户端中基本无效，靠的是 MIME 头部的Content-Type: text/html; charset=utf-8，而这个由isHtml: true触发 - 避免用 Flex/Grid 布局；
<table>+ 内联样式仍是 Outlook 等客户端唯一可靠方案
异步发送必须全程 await，不能混合同步阻塞
在 ASP.NET Core 中调用 .SendAsync() 后直接 .Result 或 .Wait()，极易引发线程死锁，尤其在 IIS 或 Kestrel 的同步上下文里。
- 控制器方法必须标记
async Task<IActionResult>，服务层方法也保持async Task - 不要在构造函数或
Startup.ConfigureServices里触发发送逻辑 - 若需后台发送（如日志告警），用
Task.Run(() => email.SendAsync())隔离上下文，但注意异常捕获
最常被忽略的一点：FluentEmail 不做连接池管理，每次 new SmtpClient 都新建 TCP 连接。高频发送场景下，务必复用 SmtpSender 实例（注册为 Singleton），而不是每次发信都 new 一个。
