.NET 6控制台应用按需托管Web API并共享DI容器的方案咨询

核心思路 #

.NET 6 的 Generic Host 完全支持同时托管后台服务（原Windows服务逻辑）和Web API端点，无需局限于纯控制台或纯Web API模式。通过配置开关控制Web主机的启动，同时所有服务共享同一个DI容器，天然满足API与主服务共享内存数据的需求。

具体实现步骤 #

1. 搭建Generic Host基础框架

使用Host.CreateDefaultBuilder()创建宿主，读取配置文件中的API启用开关，动态决定是否添加Web主机配置：

var builder = Host.CreateDefaultBuilder(args)
    .UseWindowsService() // 启用Windows服务运行支持，需安装Microsoft.Extensions.Hosting.WindowsServices包
    .ConfigureServices((hostContext, services) =>
    {
        // 注册主服务的核心依赖（共享DI容器）
        services.AddSingleton<IMemoryDataMonitor, MemoryDataMonitor>();
        // 注册原Windows服务对应的后台服务
        services.AddHostedService<MainBackgroundService>();

        // 读取API启用配置
        bool enableApi = hostContext.Configuration.GetValue<bool>("ApiSettings:Enable");
        if (enableApi)
        {
            // 注册API控制器所需服务
            services.AddControllers();
        }
    });

// 根据配置动态添加Web主机
bool enableApi = builder.Configuration.GetValue<bool>("ApiSettings:Enable");
if (enableApi)
{
    builder.ConfigureWebHostDefaults(webBuilder =>
    {
        // 配置API监听地址和端口
        webBuilder.UseUrls($"http://0.0.0.0:{builder.Configuration.GetValue<int>("ApiSettings:Port")}");
        webBuilder.Configure(app =>
        {
            app.UseRouting();
            // 映射API端点
            app.UseEndpoints(endpoints =>
            {
                endpoints.MapControllers();
            });
        });
    });
}

var host = builder.Build();
await host.RunAsync();

2. 配置文件中添加API开关

在appsettings.json中新增配置项，用于控制API启用状态和端口：

{
  "ApiSettings": {
    "Enable": true,
    "Port": 5000
  }
}

3. 实现共享数据的API控制器

控制器直接通过构造函数注入主服务的共享依赖，即可访问内存中的监控数据：

[ApiController]
[Route("api/debug")]
public class DebugController : ControllerBase
{
    private readonly IMemoryDataMonitor _dataMonitor;

    public DebugController(IMemoryDataMonitor dataMonitor)
    {
        _dataMonitor = dataMonitor;
    }

    [HttpGet("memory-data")]
    public IActionResult GetMemoryData()
    {
        var monitorData = _dataMonitor.GetCurrentData();
        return Ok(monitorData);
    }
}

4. 部署与调试

• 本地调试：直接运行控制台程序，配置Enable: true即可访问API（如http://localhost:5000/api/debug/memory-data）。
• Windows服务部署：使用sc create命令或dotnet publish生成的可执行文件注册为Windows服务，配置文件随程序一同部署，修改配置即可开关API。

关键注意事项 #

• 确保API监听端口未被占用，可通过配置文件灵活调整。
• 若需HTTPS支持，在ConfigureWebHostDefaults中添加webBuilder.UseHttps()，并配置证书。
• 主服务的后台逻辑与API控制器共享同一个DI容器，所有注册的单例/ scoped服务均可直接注入使用，无需额外数据同步。

内容的提问来源于stack exchange，提问作者A. Wheatman