Azure Functions V4(.NET6)发送邮件特殊字符编码异常问题咨询

1. 为何Azure Functions中邮件编码为Latin1，本地/App Service正常？ #

核心原因是Azure Functions宿主环境的默认进程编码与本地/App Service不同：

• 本地开发环境和App Service的宿主进程通常默认使用UTF-8编码，而Azure Functions的沙箱环境默认进程编码可能被设置为Latin1（ISO-8859-1），这是由Azure Functions的底层宿主配置决定的。
• MimeKit在未显式指定编码时，会使用当前进程的默认编码处理文本内容。当进程默认编码为Latin1时，斯堪的纳维亚字符（超出Latin1字符集范围）会被错误编码，最终显示为乱码。

2. 如何强制Azure Functions正确编码邮件消息？ #

推荐优先使用显式指定编码的方式（避免依赖环境配置），也可通过全局配置修正编码：

方法1：显式为MimeKit消息体指定UTF-8编码 #

在创建邮件内容时，直接指定HTML部分的编码为UTF-8，不依赖进程默认编码：

// 使用BodyBuilder的方式
var bodyBuilder = new BodyBuilder();
bodyBuilder.HtmlBody = "<p>Åäö</p>";
// 强制设置HTML内容的编码为UTF-8
bodyBuilder.HtmlBodyEncoding = Encoding.UTF8;

var message = new MimeMessage();
message.Body = bodyBuilder.ToMessageBody();

或者直接创建TextPart并指定编码：

var htmlPart = new TextPart("html")
{
    Text = "<p>Åäö</p>",
    ContentType = new ContentType("text", "html") { Charset = "utf-8" },
    ContentTransferEncoding = ContentEncoding.Base64 // 确保传输时编码正确
};

var message = new MimeMessage();
message.Body = htmlPart;

方法2：修改Azure Functions的全局默认编码 #

在Program.cs中设置进程的默认编码为UTF-8，确保整个应用的文本处理都使用UTF-8：

using System.Text;

var host = new HostBuilder()
    .ConfigureFunctionsWorkerDefaults()
    .ConfigureServices(services =>
    {
        // 注册编码提供者（解决.NET Core中缺少部分编码的问题）
        Encoding.RegisterProvider(CodePagesEncodingProvider.Instance);
        // 设置全局默认编码为UTF-8
        Encoding.Default = Encoding.UTF8;
        Console.OutputEncoding = Encoding.UTF8;
    })
    .Build();

host.Run();

也可通过host.json配置运行时编码：

{
  "runtime": {
    "encoding": {
      "default": "utf-8"
    }
  },
  "logging": {
    "applicationInsights": {
      "samplingSettings": {
        "isEnabled": true,
        "excludedTypes": "Request"
      }
    }
  }
}

方法3：确保HTML内容读取时使用UTF-8 #

如果HTML内容是从文件、配置或数据库读取的，读取时必须显式指定UTF-8编码，例如：

// 从文件读取HTML内容
var htmlContent = File.ReadAllText("email-template.html", Encoding.UTF8);

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