NSwag项目中的IHostedService清理问题解析

在NSwag工具的使用过程中，开发者遇到了一个与依赖注入容器中IHostedService清理相关的问题。这个问题特别影响了与Umbraco CMS集成的场景，导致无法正常生成TypeScript服务和模型。

问题背景

NSwag是一个用于生成TypeScript/JavaScript客户端代码、OpenAPI/Swagger规范以及.NET客户端代码的工具。在最新版本中，NSwag在处理ASP.NET Core应用程序时，会对依赖注入容器中的IHostedService注册进行清理操作。这个设计初衷是为了防止后台服务在代码生成过程中意外启动。

问题根源

清理操作的实现方式存在问题。当前代码使用IsAssignableFrom方法来识别所有IHostedService及其派生接口的注册，这会导致过度清理。具体来说，当某个服务接口（如Umbraco中的IRuntime）继承自IHostedService时，即使它仅以自身接口类型（IRuntime）注册，也会被错误地移除。

技术细节

在Umbraco CMS中，IRuntime接口继承自IHostedService，但它的注册方式是：

services.AddSingleton<IRuntime, Runtime>();

而非直接注册为IHostedService。然而，当前的清理逻辑会匹配所有可赋值给IHostedService的类型，导致这些必要的服务被意外移除。

解决方案

正确的做法应该是仅移除直接注册为IHostedService类型的服务，而不是所有可赋值给IHostedService的类型。即将条件判断从：

if(typeof(IHostedService).IsAssignableFrom(services[i].ServiceType))

修改为：

if(services[i].ServiceType == typeof(IHostedService))

影响范围

这个问题不仅影响Umbraco CMS，任何框架或库中如果有服务间接实现IHostedService接口但直接以自身接口类型注册的情况，都会受到相同的影响。这种过度清理会导致依赖注入容器中缺少必要的服务，进而引发各种运行时错误。

最佳实践建议

对于工具开发者来说，在进行依赖注入容器操作时应当：

1. 精确匹配服务类型，避免使用过于宽泛的类型判断
2. 考虑提供配置选项，允许用户自定义哪些服务需要保留
3. 在清理操作前记录将被移除的服务，便于调试

对于NSwag用户来说，如果遇到类似问题，可以：

1. 检查项目中是否有间接实现IHostedService的关键服务
2. 考虑暂时降级NSwag版本
3. 等待官方修复并升级到包含修复的版本

这个问题提醒我们在处理依赖注入容器时需要格外小心，特别是在工具类库中，因为任何修改都可能影响用户应用程序的核心功能。