重构DI模式后Windows服务启动失败：IOpcLogger依赖无法解析

问题背景 #

• 基于OPC UA协议的后台数据采集服务正在重构，目标是引入**依赖注入(DI)**模式
• 第一步改造：将原有硬编码的FileLogger改为可注入服务，通过构造函数注入到OpcUaWorker（Hosted Service）中

故障现象 #

• 硬编码日志路径传入OpcFileLogger构造函数后，服务启动即终止，OpcUaWorker的StartAsync方法未执行（添加的StreamWriter测试文件无生成）
• 使用带工厂委托的AddSingleton注册IOpcLogger时服务启动失败，仅无参构造的AddSingleton（硬编码路径）能正常运行
• 事件查看器捕获核心错误：

System.InvalidOperationException: 激活OpcService.OpcUaWorker时无法解析OpcService.Services.IOpcLogger服务。

解决步骤 #

1. 修正IOpcLogger的容器注册逻辑 #

确保容器正确完成接口与实现类的映射，工厂委托能无异常实例化OpcFileLogger：

// 正确的带参数工厂注册示例
services.AddSingleton<IOpcLogger>(sp => 
{
    // 使用绝对路径避免相对路径问题
    string logDir = Path.Combine(AppContext.BaseDirectory, "OpcLogs");
    // 确保目录存在，避免创建文件时抛出异常
    Directory.CreateDirectory(logDir);
    string logFilePath = Path.Combine(logDir, $"opc-collect-{DateTime.Now:yyyyMMdd}.log");
    return new OpcFileLogger(logFilePath);
});

• 注意：工厂委托内的路径逻辑必须无异常（如权限、路径合法性），否则会导致实例化失败，容器无法解析服务

2. 验证OpcUaWorker的构造函数注入 #

确保OpcUaWorker的构造函数仅依赖已注册服务，无未解析的依赖项：

public class OpcUaWorker : BackgroundService
{
    private readonly IOpcLogger _logger;

    // 仅注入已在容器注册的IOpcLogger
    public OpcUaWorker(IOpcLogger logger)
    {
        _logger = logger;
    }

    protected override async Task ExecuteAsync(CancellationToken stoppingToken)
    {
        // 业务逻辑实现
    }
}

3. 捕获容器初始化时的详细异常 #

在主机构建阶段添加异常捕获，直接定位初始化失败的具体原因：

try
{
    var host = Host.CreateDefaultBuilder(args)
        .ConfigureServices(services =>
        {
            services.AddHostedService<OpcUaWorker>();
            services.AddSingleton<IOpcLogger>(sp => new OpcFileLogger("合法的绝对日志路径"));
        })
        .Build();

    await host.RunAsync();
}
catch (Exception ex)
{
    // 将异常写入临时文件，便于排查
    File.WriteAllText("service-init-error.log", ex.ToString());
    throw;
}

• 此方法可获取比事件查看器更详细的异常栈，精准定位问题

4. 检查日志路径权限 #

• 确保日志目录所在路径有写入权限（尤其是Windows服务运行时，默认服务账户权限有限）
• 优先使用基于程序安装目录的绝对路径，避免相对路径引发的权限或路径解析问题

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