添加项目引用后.NET Core API发布到IIS失败该如何解决？

问题原因及解决方案 #

• 引用程序集未开启复制本地属性
  Debug模式运行时会自动读取本地项目bin目录下的所有依赖文件，而发布到IIS时，默认只会打包「复制本地」属性为True的程序集。如果新增引用的该属性为False，发布后IIS会因找不到对应依赖报错。
  解决步骤：右键新增的引用项，选择「属性」，找到复制本地（部分版本VS显示为Copy Local）选项，设置为True后重新发布即可。
• 发布配置未包含依赖项输出
  如果新增的是同解决方案的项目引用，需要检查发布配置：确认「要部署的项目输出」勾选了对应依赖项目，若开启了发布前预编译，也要确认依赖项未被排除在预编译范围外。
• IIS应用池框架版本不匹配
  若新增引用的目标框架和当前IIS站点绑定的应用池框架版本不兼容，也会触发发布/运行报错。比如引用基于.NET 6编译，但应用池配置的是.NET Framework 4.x，或是.NET Core/.NET 5+项目的应用池未设置为「无托管代码」。
  解决步骤：打开IIS管理器，找到站点对应的应用程序池，右键选择「基本设置」，调整.NET CLR版本和项目目标框架一致即可。
• 程序集架构与IIS配置不匹配
  如果新增的引用仅支持32位架构，而IIS对应应用池未开启32位应用支持，也会出现加载失败问题。
  解决步骤：右键对应应用池选择「高级设置」，找到「启用32位应用程序」选项，设置为True后重启站点即可。

排查小技巧：可以先打开本地发布的输出文件夹，确认是否存在新增引用对应的dll文件，如果不存在优先排查复制本地和发布配置项。

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