.NET Core Worker Service使用默认配置读取appsettings.json失败的问题咨询

我来帮你理清问题出在哪，以及怎么用默认配置让Worker Service正常读取appsettings.json的内容。你的核心问题是Program.cs里的配置处理逻辑破坏了.NET Core Host默认的配置加载流程，导致注入的IConfiguration没有正确读取到配置文件。

为什么之前的写法会失败？ #

第一次Program.cs的问题 #

在ConfigureAppConfiguration里手动调用了.Build()，这完全是画蛇添足——ConfigureAppConfiguration的作用是配置配置构建器的规则，宿主会在初始化流程中自动调用Build生成最终的IConfiguration实例。手动调用Build不仅不会生效，反而会干扰默认的配置链，导致注入的IConfiguration丢失了appsettings.json的内容。

第二次Program.cs的问题 #

在ConfigureServices里手动构建配置并赋值给hostContext.Configuration，这时候宿主已经完成了IConfiguration的初始化，依赖注入容器里的实例已经是默认的空配置（没有读取你的appsettings.json），所以你手动构建的配置根本没被注入到服务中，自然读不到值。

正确写法：利用Host默认配置加载 #

其实Host.CreateDefaultBuilder已经帮你做好了所有基础配置工作，你只需要保持最简的Program.cs即可：

public class Program
{
    public static void Main(string[] args)
    {
        CreateHostBuilder(args).Build().Run();
    }

    public static IHostBuilder CreateHostBuilder(string[] args) =>
        Host.CreateDefaultBuilder(args)
            .ConfigureServices((hostContext, services) =>
            {
                services.AddHostedService<ImageFileWatcher>();
            });
}

Host.CreateDefaultBuilder会自动加载以下配置源（按优先级从低到高）：

• 当前目录下的appsettings.json
• 当前目录下的appsettings.{环境名}.json（比如appsettings.Development.json）
• 环境变量
• 命令行参数

这样你的appsettings.json里的WatcherConfig:filePath就能被正常读取了。

验证读取逻辑 #

你的ImageFileWatcher类不需要修改，保持原有的构造函数注入IConfiguration即可：

public class ImageFileWatcher : IHostedService, IDisposable { 
    private readonly ILogger<ImageFileWatcher> _logger; 
    private readonly IConfiguration _configuration; 
    private FileSystemWatcher _watcher; 

    public ImageFileWatcher(ILogger<ImageFileWatcher> logger, IConfiguration configuration) { 
        _logger = logger; 
        _configuration = configuration; 
    } 

    public Task StartAsync(CancellationToken cancellationToken) { 
        var watcherConfig = _configuration["WatcherConfig:filePath"];
        if(string.IsNullOrEmpty(watcherConfig))
        {
            _logger.LogError("配置项 WatcherConfig:filePath 未找到！");
            return Task.CompletedTask;
        }
        
        _logger.LogInformation($"Image File watcher started on path {watcherConfig}"); 
        _watcher = new FileSystemWatcher(watcherConfig); 
        _watcher.Created += OnNewImage; 
        _watcher.EnableRaisingEvents = true; 
        return Task.CompletedTask; 
    }

    // 补充OnNewImage和Dispose方法实现
    private void OnNewImage(object sender, FileSystemEventArgs e)
    {
        _logger.LogInformation($"New image detected: {e.FullPath}");
    }

    public void Dispose()
    {
        _watcher?.Dispose();
    }
}

进阶推荐：使用IOptions强类型绑定 #

直接用IConfiguration读取字符串不够优雅，也没有类型检查，推荐用.NET Core官方推荐的IOptions模式来绑定配置：

1. 创建强类型配置类：

public class WatcherConfig
{
    public string FilePath { get; set; }
}

2. 在Program.cs里绑定配置：

public static IHostBuilder CreateHostBuilder(string[] args) =>
    Host.CreateDefaultBuilder(args)
        .ConfigureServices((hostContext, services) =>
        {
            // 将配置节绑定到强类型类
            services.Configure<WatcherConfig>(hostContext.Configuration.GetSection("WatcherConfig"));
            services.AddHostedService<ImageFileWatcher>();
        });

3. 修改ImageFileWatcher注入IOptions<WatcherConfig>：

public class ImageFileWatcher : IHostedService, IDisposable { 
    private readonly ILogger<ImageFileWatcher> _logger; 
    private readonly WatcherConfig _watcherConfig; 
    private FileSystemWatcher _watcher; 

    public ImageFileWatcher(ILogger<ImageFileWatcher> logger, IOptions<WatcherConfig> watcherConfig) { 
        _logger = logger; 
        _watcherConfig = watcherConfig.Value; 
    } 

    public Task StartAsync(CancellationToken cancellationToken) { 
        if(string.IsNullOrEmpty(_watcherConfig.FilePath))
        {
            _logger.LogError("配置项 WatcherConfig:FilePath 未找到！");
            return Task.CompletedTask;
        }
        
        _logger.LogInformation($"Image File watcher started on path {_watcherConfig.FilePath}"); 
        _watcher = new FileSystemWatcher(_watcherConfig.FilePath); 
        _watcher.Created += OnNewImage; 
        _watcher.EnableRaisingEvents = true; 
        return Task.CompletedTask; 
    }

    // 其他方法实现同上
}

这种方式不仅有类型安全保障，还能获得IDE智能提示，更符合.NET Core的最佳实践。

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