ServiceStack v5版本异常：基于.NET Framework的ASP.NET Core应用故障

咱们一步步拆解怎么解决你遇到的问题——你的应用是托管在Windows Service里、TargetFramework配置为.NET Framework的ASP.NET Core项目，之前用ServiceStack.Core 1.0.44运行正常，升级到5.x版本后出异常，核心原因是ServiceStack从1.x到5.x做了重大的包结构和API调整，尤其是针对.NET Framework场景的支持逻辑变了。

1. 替换旧的Core系列包为5.x标准包 #

你之前用的ServiceStack.Core、ServiceStack.Kestrel、ServiceStack.Text.Core是早期ServiceStack针对.NET Core推出的轻量化包，但5.x版本统一了包体系，针对.NET Framework的ASP.NET Core应用，必须改用不带.Core后缀的标准包：

• 先移除项目里的旧包引用：

  <PackageReference Include="ServiceStack.Core" Version="1.0.44" />
  <PackageReference Include="ServiceStack.Kestrel" Version="1.0.44" />
  <PackageReference Include="ServiceStack.Text.Core" Version="1.0.44" />
  

• 然后添加对应5.x稳定版本的标准包（比如5.13.0，你可以选最新的5.x稳定版）：

  <PackageReference Include="ServiceStack" Version="5.13.0" />
  <PackageReference Include="ServiceStack.Kestrel" Version="5.13.0" />
  <PackageReference Include="ServiceStack.Text" Version="5.13.0" />
  

2. 检查Windows Service的Kestrel集成代码 #

ServiceStack 5.x对Kestrel的集成方式做了更新，得确保你的服务启动代码符合新规范：

• 打开Program.cs，确认WebHostBuilder（或者用Host.CreateDefaultBuilder的话）正确引入ServiceStack：

  public static IWebHostBuilder CreateWebHostBuilder(string[] args) =>
      WebHost.CreateDefaultBuilder(args)
          .UseKestrel()
          .UseServiceStack(new AppHost()) // 这里要保证你的AppHost继承自ServiceStack.AppHostBase
          .UseStartup<Startup>();
  

• 如果你的AppHost有自定义配置（比如注册插件、设置路由），检查下有没有用5.x里已经废弃的API——比如某些旧的插件注册方法、配置属性，这些都得换成5.x的对应API。

3. 确认目标框架兼容性 #

你的项目TargetFramework是.NET Framework，得保证5.x版本的ServiceStack支持它：

• ServiceStack 5.x最低支持.NET Framework 4.6.1，所以先确认你的项目TargetFramework设置正确，比如：

  <TargetFramework>net472</TargetFramework>
  

• 另外要注意ASP.NET Core版本和ServiceStack 5.x的兼容性：比如5.x后期版本对应ASP.NET Core 3.1及以上，如果你的ASP.NET Core版本太低，要么升级ASP.NET Core，要么选适配低版本的ServiceStack 5.x分支。

4. 定位具体异常（如果前面步骤没解决） #

要是做完上面的步骤还是有异常，得抓具体的错误信息才能精准修复：

• 在Windows Service的启动代码里加全局异常捕获，或者去Windows事件日志里找错误详情——比如是类型找不到、方法不存在，还是依赖包冲突？
• 常见的坑比如：旧的ServiceStack API被移除导致编译报错，或者其他依赖包和新的ServiceStack版本不兼容，这时候就根据错误提示调整代码或者包版本就行。

举个例子，如果遇到TypeLoadException说找不到ServiceStack.AppHostBase的某个方法，那大概率是你的AppHost代码用了5.x废弃的方法，比如Configure方法签名变了，这时候就得改成新的签名。

内容的提问来源于stack exchange，提问作者Mr.Wang from Next Door