WebAPI独立程序集下如何加载Host程序集的launchSettings.json

你当前的问题是因为Host.CreateDefaultBuilder默认仅加载入口程序集（Host）目录下的标准配置文件（如appsettings.json），但launchSettings.json默认存放在Properties文件夹中，且在拆分WebAPI为独立类库的场景下，WebHost不会自动读取Host程序集内的launchSettings配置——原本IDE会在开发时自动注入launchSettings，但拆分后这个逻辑失效了。

解决方案步骤 #

1. 在Host程序集中手动加载launchSettings.json

修改Host的Program.cs，添加自定义配置源，明确加载Host程序集输出目录下的Properties/launchSettings.json：

using System.IO;
using System.Reflection;

internal class Program
{
    static async Task Main(string[] args)
    {
        var builder = Host.CreateDefaultBuilder(args);
        
        // 手动加载Host程序集所在目录的launchSettings.json
        builder.ConfigureAppConfiguration((context, config) =>
        {
            // 获取Host程序集的输出路径
            var hostAssemblyDir = Path.GetDirectoryName(Assembly.GetExecutingAssembly().Location);
            // 拼接launchSettings的完整路径
            var launchSettingsPath = Path.Combine(hostAssemblyDir, "Properties", "launchSettings.json");
            
            // 如果文件存在则添加到配置源
            if (File.Exists(launchSettingsPath))
            {
                config.AddJsonFile(launchSettingsPath, optional: false, reloadOnChange: true);
            }
        });

        builder.ConfigureServices((context, services) =>
        {
            // 原有领域层配置逻辑...
        });

        builder.ConfigureWebApi();

        var app = builder.Build();
        await app.RunAsServiceAsync();
    }
}

2. 让WebHost复用Host的配置上下文

修改WebAPI的StartupExtensions.cs，确保WebHost使用Host已加载的配置（包括launchSettings），而不是重新初始化配置源：

public static class StartupExtensions
{
    public static void ConfigureWebApi(this IHostBuilder builder)
    {
        builder.ConfigureWebHostDefaults(webBuilder =>
        {
            // 关键：让WebHost使用Host的配置上下文，继承已加载的launchSettings
            webBuilder.UseConfiguration(builder.GetContext().Configuration);

            webBuilder.ConfigureServices(services =>
            {
                services
                    .AddControllers()
                    .AddXmlSerializerFormatters()
                    .AddApplicationPart(Assembly.GetExecutingAssembly()); 
                services.AddEndpointsApiExplorer();
                services.AddSwaggerGen();
            });

            webBuilder.Configure((context, app) =>
            {
                app.UseDeveloperExceptionPage();
                app.UseSwagger();
                app.UseSwaggerUI();

                app.UseHttpsRedirection();
                app.UseRouting();
                app.UseEndpoints(endpoints =>
                {
                    endpoints.MapControllers();
                });
            });
        });
    }
}

关键注意事项 #

• 设置launchSettings.json的复制属性：在Host项目中，右键Properties/launchSettings.json → 属性 → 复制到输出目录，选择「始终复制」或「较新时复制」，确保文件能被输出到Host程序集的目录中。
• 配置优先级：.NET的配置优先级规则依然生效——如果存在环境变量（如ASPNETCORE_URLS）、命令行参数，会覆盖launchSettings.json中的配置。

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