升级MailKit至4.9.0后仍遇System.Buffers程序集加载异常求助

问题背景 #

• 初始使用MailKit 4.8.0时，创建MimeMessage实例触发FileLoadException，提示System.Runtime.CompilerServices.Unsafe版本错误，尝试通过.exe.config和.dll.config绑定版本无效
• 升级至MailKit与MimeKit 4.9.0后，调用SmtpClient.Connect时（尚未执行到MimeMessage创建步骤）仍抛出FileLoadException，涉及System.Buffers版本不匹配

异常详情 #

System.IO.FileLoadException
  HResult=0x80131040
  Message=Could not load file or assembly 'System.Buffers, Version=4.6.0.0, Culture=neutral, PublicKeyToken=cc7b13ffcd2ddd51' or one of its dependencies. The located assembly's manifest definition does not match the assembly reference. (Exception from HRESULT: 0x80131040)
  Source=MailKit
  StackTrace:
   at MailKit.ByteArrayBuilder..ctor(Int32 initialCapacity)
   at MailKit.Net.Smtp.SmtpStream.ReadResponse(CancellationToken cancellationToken)
   at MailKit.Net.Smtp.SmtpClient.PostConnect(Stream stream, String host, Int32 port, SecureSocketOptions options, Boolean starttls, CancellationToken cancellationToken)
   at MailKit.Net.Smtp.SmtpClient.Connect(String host, Int32 port, SecureSocketOptions options, CancellationToken cancellationToken)
   at ISolCommExtMAPI.SMTPMail64.Send() in C:\IPS\v25.1\Source\Components\IrisCommsProjects\ISolCommExtMAPI\ISolCommExtMAPI\SMTPMail64.cpp:line 68

Inner Exception 1:
FileLoadException: Could not load file or assembly 'System.Buffers, Version=4.0.4.0, Culture=neutral, PublicKeyToken=cc7b13ffcd2ddd51' or one of its dependencies. The located assembly's manifest definition does not match the assembly reference. (Exception from HRESULT: 0x80131040)

相关C++/CLI代码片段 #

SmtpClient^ client = nullptr;

try
{
    //specify SMTP Server
    client = gcnew SmtpClient();
    client->RequireTLS = true;
    // MailKit 4.9 throws FileLoadException here:
    client->Connect(_emSMTPServer, _emSMTPPort, MailKit::Security::SecureSocketOptions::StartTls, System::Threading::CancellationToken::None); 
    NetworkCredential^ credentials = gcnew NetworkCredential(_emUserName, _emPassword);
    client->Authenticate(System::Text::Encoding::UTF8, credentials, System::Threading::CancellationToken::None);
    // MimeKit 4.8 threw FileLoadException here:
    message = gcnew MimeMessage();
    // ...
}

已尝试操作 #

在.exe.config中添加程序集绑定配置，也尝试为相关DLL添加.dll.config并配置相同绑定规则，但异常仍存在，且异常消息与内部异常的版本号不一致；此前也曾遇到System.Runtime.CompilerServices.Unsafe的同类版本问题。

解决建议 #

1. 完善程序集绑定配置 #

确保.exe.config中同时包含System.Buffers和System.Runtime.CompilerServices.Unsafe的完整绑定重定向，覆盖所有可能冲突的版本范围。示例配置：

<configuration>
  <runtime>
    <assemblyBinding xmlns="urn:schemas-microsoft-com:asm.v1">
      <!-- 处理System.Buffers版本冲突 -->
      <dependentAssembly>
        <assemblyIdentity name="System.Buffers" publicKeyToken="cc7b13ffcd2ddd51" culture="neutral" />
        <bindingRedirect oldVersion="0.0.0.0-4.6.0.0" newVersion="4.6.0.0" />
      </dependentAssembly>
      <!-- 处理System.Runtime.CompilerServices.Unsafe版本冲突 -->
      <dependentAssembly>
        <assemblyIdentity name="System.Runtime.CompilerServices.Unsafe" publicKeyToken="b03f5f7f11d50a3a" culture="neutral" />
        <bindingRedirect oldVersion="0.0.0.0-6.0.0.0" newVersion="6.0.0.0" />
      </dependentAssembly>
    </assemblyBinding>
  </runtime>
</configuration>

• 注意：C++/CLI项目的配置文件必须与输出的.exe同名（如YourApp.exe.config），且放置在同一目录下，.dll.config仅适用于类库，主程序优先读取.exe.config。

2. 统一NuGet依赖版本 #

• 清理项目的packages目录，重新执行NuGet包还原操作，确保MailKit/MimeKit及其依赖的System.Buffers、System.Runtime.CompilerServices.Unsafe版本完全一致
• 在NuGet包管理器中检查所有项目的依赖项，确认没有跨版本引用冲突，优先使用MailKit要求的最低依赖版本

3. 验证输出目录的程序集版本 #

• 打开项目输出目录（如bin/Debug），找到System.Buffers.dll和System.Runtime.CompilerServices.Unsafe.dll，右键查看「属性→详细信息」，确认程序集版本与配置文件中newVersion一致
• 若版本不匹配，手动替换为NuGet安装的正确版本，或检查项目引用设置，移除旧版本的本地引用，确保引用的是NuGet提供的程序集

4. 启用程序集绑定日志排查 #

使用fuslogvw.exe（程序集绑定日志查看器）捕获详细绑定失败日志，定位具体问题：

• 以管理员身份运行fuslogvw.exe
• 点击「设置」，选择「记录所有绑定失败到磁盘」并指定日志目录
• 重新运行程序触发异常，返回fuslogvw.exe查看日志，获取具体的绑定失败原因

5. 确认项目目标框架兼容性 #

确保C++/CLI项目的目标.NET框架版本与MailKit 4.x支持的版本匹配（MailKit 4.x要求.NET 6及以上），目标框架过低可能导致依赖程序集版本不兼容

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