ASP.NET Core部署至Windows主机启动失败：无法加载ServiceStack程序集求助

我之前也踩过类似Windows主机部署ServiceStack项目的坑，结合你的情况整理了几个针对性的解决方案，你可以逐个排查：

1. 确认主机已安装正确的.NET Core运行时环境 #

Windows主机部署ASP.NET Core项目必须安装ASP.NET Core 3.1 Runtime（含Windows Hosting Bundle），不少廉价Windows主机默认可能只装了基础.NET Framework或不完整的.NET Core Runtime：

• 直接联系主机商确认是否已安装对应版本的Hosting Bundle；
• 如果有主机控制面板，也可以自行查看已安装的运行时列表，尽量保证版本小版本完全匹配（比如3.1.20和3.1.30这类小版本差异也可能引发兼容问题）。

2. 验证ServiceStack依赖是否完整部署 #

WebDeploy的增量部署偶尔会漏掉NuGet依赖包，导致主机bin目录缺少关键文件：

• 本地先执行完整发布命令生成发布包：

  dotnet publish -c Release
  

  然后手动将整个发布文件夹上传到主机，替代WebDeploy的直接部署；
• 检查项目.csproj文件，确保ServiceStack相关包的依赖会被复制到输出目录，可添加如下配置（如果没有的话）：

  <PackageReference Include="ServiceStack" Version="5.7.0" PrivateAssets="all" />
  <PackageReference Include="ServiceStack.Interfaces" Version="5.7.0" PrivateAssets="all" />
  <PackageReference Include="ServiceStack.Text" Version="5.7.0" PrivateAssets="all" />
  

• 登录主机文件管理器，查看网站bin目录下是否存在ServiceStack.dll及所有关联的依赖文件，若有缺失则手动补充。

3. 修正自包含部署的配置细节 #

如果采用自包含模式，需确保发布配置与主机环境完全匹配：

• 发布时指定正确的Windows目标运行时，比如主机是x64架构则执行：

  dotnet publish -c Release -r win-x64 --self-contained true
  

• 登录主机IIS控制面板，找到对应应用程序池，将启用32位应用程序设置与发布架构匹配：x64设为False，x86设为True。

4. 调整IIS应用程序池的CLR版本 #

ASP.NET Core项目不需要依赖IIS的托管CLR，若设置错误会直接导致加载异常：

• 在主机IIS的应用程序池设置中，将**.NET CLR版本改为无托管代码**，这是ASP.NET Core项目的标准配置。

5. 排查权限与详细日志 #

如果以上方法都无效，需要深挖错误根源：

• 开启IIS的失败请求跟踪，获取更详细的错误堆栈，确认是哪个依赖缺失或加载失败；
• 检查网站目录的文件权限，确保应用程序池用户对bin目录有读取权限，部分主机默认权限设置会限制程序集读取；
• 查看主机控制面板提供的网站日志，寻找更具体的错误提示（比如权限拒绝、文件不存在等）。

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