.NET Aspire如何为所有服务提供全局默认配置？

核心问题原因 #

.NET Aspire子服务默认只会加载自身项目内的配置文件，不会自动读取AppHost的配置内容，所以ApiService无法获取到AppHost里的AppConfig.Two默认值。

解决方案一：通过AppHost传递默认配置 #

这是Aspire官方推荐的跨服务配置传递方式，步骤如下：

• 在AppHost项目中读取默认配置节点
• 将配置传递给子服务，子服务会自动合并自身配置（自身配置优先级更高）

示例代码（AppHost/Program.cs）：

// 读取AppHost的AppConfig默认配置
var appConfigDefaults = builder.Configuration.GetSection("AppConfig").Get<AppConfig>();

// 添加ApiService并传递默认配置
builder.AddProject<Projects.ApiService>("apiservice")
       .WithConfiguration("AppConfig", appConfigDefaults);

这样ApiService启动时，会同时加载自身appsettings.json的配置和AppHost传递的默认配置，自身重写的One会生效，未重写的Two会使用AppHost的默认值。

解决方案二：使用共享默认配置文件 #

通过共享程序集提供通用配置文件，让所有服务统一加载：

1. 在ServiceDefaults项目中添加appsettings.defaults.json，写入默认配置：

{
  "AppConfig": {
    "One": "DefaultOne",
    "Two": "DefaultTwo"
  }
}

2. 修改ServiceDefaults中的AddCustomConfiguration扩展方法，让服务优先加载自身配置，再合并共享默认配置：

public static IServiceCollection AddCustomConfiguration(this IServiceCollection services, IConfiguration config)
{
    // 加载共享默认配置
    var sharedConfig = new ConfigurationBuilder()
        .AddJsonFile(Path.Combine(AppContext.BaseDirectory, "appsettings.defaults.json"), optional: false)
        .Build();

    // 合并配置：自身配置覆盖共享默认配置
    var combinedConfig = config.GetSection("AppConfig").Combine(sharedConfig.GetSection("AppConfig"));
    services.Configure<AppConfig>(combinedConfig);

    return services;
}

3. 将appsettings.defaults.json的“复制到输出目录”设置为“始终复制”，确保所有服务启动时能读取到该文件。

配置优先级说明 #

两种方案都遵循以下优先级（从高到低）：

• 子服务自身appsettings.json的配置
• AppHost传递的默认配置 / 共享默认配置
• 框架默认配置

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