将项目引用替换为NuGet包后Web应用程序出现程序集未找到错误求助

1. 检查NuGet包的程序集完整性 #

• 把你的NuGet包后缀改成.zip解压，查看lib/netstandard2.0或lib/net462目录下是否包含类库的主程序集和所有依赖程序集。
• 如果类库依赖其他第三方NuGet包，要么打包时通过配置把依赖项包含进来，要么在Web项目里手动安装这些依赖包。

2. 验证Web项目的NuGet引用配置 #

• 打开packages.config，确认你的NuGet包条目存在，版本和目标框架（net462）匹配，比如：

  <package id="YourLibraryName" version="1.0.0" targetFramework="net462" />
  

• 右键Web项目→管理NuGet程序包，确认包已正常安装，没有兼容性警告。
• 查看Web项目的引用列表，找到NuGet对应的程序集，右键→属性，确认“复制本地”设为True。

3. 清理重建解决方案 #

• 删除Web项目的bin和obj目录，清空NuGet缓存（命令行执行nuget locals all -clear）。
• 重新编译NuGet包（本地打包的话），再重新安装到Web项目，最后完整重建整个解决方案。

4. 检查程序集绑定重定向 #

• 打开Web项目的web.config，如果类库和Web项目依赖的程序集版本不一致，需要添加绑定重定向，示例：

  <runtime>
    <assemblyBinding xmlns="urn:schemas-microsoft-com:asm.v1">
      <dependentAssembly>
        <assemblyIdentity name="YourLibraryAssembly" publicKeyToken="xxxx" culture="neutral" />
        <bindingRedirect oldVersion="0.0.0.0-1.0.0.0" newVersion="1.0.0.0" />
      </dependentAssembly>
    </assemblyBinding>
  </runtime>
  

• 也可以开启自动生成：右键Web项目→属性→应用程序→勾选“自动生成绑定重定向”，然后重新生成项目。

5. 确认NuGet包的目标框架兼容性 #

• 检查类库项目的.csproj，如果是单目标框架，确认是netstandard2.0；如果用到了.NET 4.6.2专属API，建议改成多目标编译：

  <TargetFrameworks>net462;netstandard2.0</TargetFrameworks>
  

• .NET 4.6.2兼容.NET Standard 2.0，但如果包的目标框架配置错误，会导致运行时找不到程序集。

6. 检查运行环境配置（IIS部署场景） #

• 如果在IIS上运行，确认应用程序池的.NET CLR版本是v4.0，如果程序集是32位，要启用“允许32位应用程序”。
• 检查IIS站点物理路径下的bin目录，确认NuGet包的程序集已经被复制过来，没复制的话手动拷贝测试。

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