.NET 6.0 Web API如何读取非当前项目的配置文件？

在.NET 6的Web API项目里，默认只能读取当前项目的appsettings.json，但如果需要加载其他项目（比如类库、独立配置项目）里的配置文件，有几种实用方法：

方法1：直接指定配置文件路径加载 #

最直接的方式是在Program.cs中，通过配置构建器手动添加外部配置文件的路径。

var builder = WebApplication.CreateBuilder(args);

// 加载外部项目的配置文件，替换为你的实际路径
// 相对路径需注意运行时工作目录，也可以用绝对路径
builder.Configuration.AddJsonFile(@"..\OtherConfigProject\appsettings.json", 
                                  optional: true, 
                                  reloadOnChange: true);

// 正常注册服务
builder.Services.AddControllers();

var app = builder.Build();

// 中间件配置
app.UseAuthorization();
app.MapControllers();

app.Run();

参数说明：

• optional: true：配置文件不存在时不会抛出异常，适合非必填的外部配置
• reloadOnChange: true：配置文件修改时自动重新加载，无需重启服务

方法2：通过命令行/环境变量动态指定路径 #

如果不想在代码里硬编码路径，可以通过命令行参数或环境变量传递外部配置的路径，灵活性更高。

命令行参数方式 #

启动项目时传入参数：

dotnet run --external-config="D:\Projects\OtherProject\appsettings.json"

然后在Program.cs中读取并加载：

var builder = WebApplication.CreateBuilder(args);

var externalConfigPath = builder.Configuration["external-config"];
if (!string.IsNullOrEmpty(externalConfigPath))
{
    builder.Configuration.AddJsonFile(externalConfigPath, optional: true, reloadOnChange: true);
}

// ...后续配置

环境变量方式 #

设置环境变量（比如ASPNETCORE_EXTERNAL_CONFIG），然后在代码中读取：

var builder = WebApplication.CreateBuilder(args);

var externalConfigPath = Environment.GetEnvironmentVariable("ASPNETCORE_EXTERNAL_CONFIG");
if (!string.IsNullOrEmpty(externalConfigPath))
{
    builder.Configuration.AddJsonFile(externalConfigPath, optional: true, reloadOnChange: true);
}

// ...后续配置

方法3：封装扩展方法复用逻辑 #

如果多个项目都需要加载外部配置，可以封装一个扩展方法简化代码：

public static class ExternalConfigurationExtensions
{
    public static IConfigurationBuilder AddExternalJsonConfig(this IConfigurationBuilder builder, string filePath)
    {
        if (!string.IsNullOrWhiteSpace(filePath))
        {
            builder.AddJsonFile(filePath, optional: true, reloadOnChange: true);
        }
        return builder;
    }
}

使用时直接调用：

var builder = WebApplication.CreateBuilder(args);
builder.Configuration.AddExternalJsonConfig(@"..\OtherProject\appsettings.json");

// ...后续配置

注意事项 #

• 相对路径的基准是项目的运行目录，开发时通常是项目根目录，但部署后可能需要调整路径
• 如果外部配置和当前项目的配置有重复键，外部配置不会覆盖当前配置，除非调整加载顺序（默认先加载默认配置，后添加的配置会覆盖之前的）

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