MailKit/MimeKit部署报错：找不到System.Buffers 4.0.2.0

一、MailKit/MimeKit依赖溯源 #

• 查看直接依赖：在VS解决方案资源管理器中右键项目→「管理NuGet程序包」，切换到「已安装」标签找到MailKit，查看其依赖项是否包含System.Buffers 4.0.2.0；也可通过NuGet官网搜索MailKit 3.6.0，查看官方依赖明细。
• 排查间接依赖：在本地项目目录执行命令 dotnet list package --include-transitive，输出所有直接、间接依赖的版本信息，定位System.Buffers 4.0.2.0的引用来源（可能是MailKit的子依赖，比如MimeKit或其他底层库）。

二、服务器端程序集冲突排查 #

• 确认文件版本：检查服务器应用bin目录下的System.Buffers.dll版本是否为4.0.3.0，同时排查服务器全局程序集缓存（GAC）或bin子文件夹中是否存在4.0.2.0版本的文件。
• 添加程序集绑定重定向：在Web.config中配置重定向规则，强制将对System.Buffers 4.0.2.0的请求指向4.0.3.0，示例配置如下：

<runtime>
  <assemblyBinding xmlns="urn:schemas-microsoft-com:asm.v1">
    <dependentAssembly>
      <assemblyIdentity name="System.Buffers" publicKeyToken="cc7b13ffcd2ddd51" culture="neutral" />
      <bindingRedirect oldVersion="0.0.0.0-4.0.2.0" newVersion="4.0.3.0" />
    </dependentAssembly>
  </assemblyBinding>
</runtime>

三、发布流程验证 #

• 检查引用属性：右键项目中的System.Buffers引用→「属性」，确保「复制本地」设置为True，避免发布时遗漏依赖文件。
• 清理旧文件：发布前删除服务器应用目录下的旧bin文件，防止残留旧版本程序集引发冲突。

四、版本引用说明 #

MailKit 3.6.0本身大概率不会直接引用System.Buffers 4.0.2.0，但它的依赖链可能包含该版本的引用，通过上述依赖溯源步骤可明确具体来源。

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