ASP.NET Core中的配置系统是什么？如何读取配置？

星降

发布时间：2025-09-11 09:12:01

295人浏览过

来源于php中文网

原创

ASP.NET Core配置系统通过IConfiguration接口和Options模式实现灵活配置管理，支持多来源配置聚合与环境特定设置，利用提供者模型和层次化结构确保扩展性与覆盖机制，结合环境变量优先级保障安全与部署灵活性，推荐使用IOptionsSnapshot和IOptionsMonitor实现配置热更新与实时响应变更。

asp.net core中的配置系统是什么？如何读取配置？

ASP.NET Core的配置系统，在我看来，是这个框架最精妙也最实用的设计之一。它本质上提供了一套灵活且可扩展的机制，用于管理应用程序的各种设置，比如数据库连接字符串、API密钥、自定义业务参数等等。它的核心理念就是将配置信息从代码中分离出来，并且能够从多种来源（文件、环境变量、命令行参数、密钥管理服务等）读取，并以一种统一的方式供应用使用。至于如何读取配置，最直接的方式就是通过框架提供的

IConfiguration

接口，它是一个键值对集合，能让你以编程方式访问这些设置。

解决方案

在ASP.NET Core中读取配置，最常见的起点是

appsettings.json

文件，但系统会聚合多种来源。核心流程通常是这样的：

构建配置： 默认情况下，ASP.NET Core的Web主机（或通用主机）在启动时会自动构建
```
IConfiguration
```
实例。它会按特定顺序加载配置源，例如：
- ```
appsettings.json
```
- ```
appsettings.{EnvironmentName}.json
```
  (例如
```
appsettings.Development.json
```
  )
- 用户机密（仅在开发环境）
- 环境变量
- 命令行参数后加载的配置会覆盖先加载的同名配置。

注入

IConfiguration

：在你的应用程序代码中，最推荐的做法是通过依赖注入（DI）机制获取

IConfiguration

实例。无论是在控制器、服务还是其他组件中，你都可以像这样请求它：

public class MyService
{
    private readonly IConfiguration _configuration;

    public MyService(IConfiguration configuration)
    {
        _configuration = configuration;
    }

    public void DoSomething()
    {
        // 读取一个简单的值
        string connectionString = _configuration["ConnectionStrings:DefaultConnection"];

        // 读取一个配置节
        var mySettingsSection = _configuration.GetSection("MyCustomSettings");
        string someValue = mySettingsSection["SomeKey"]; // 等同于 _configuration["MyCustomSettings:SomeKey"]
        int limit = _configuration.GetValue("MyCustomSettings:Limit", 100); // 带默认值

        // ... 使用这些配置值
    }
}

使用Options模式（更推荐）： 对于更复杂的配置结构，或者当你希望配置是强类型时，Options模式（

IOptions

）是更好的选择。它将配置值映射到一个C#类，提供了类型安全和更好的结构。

首先，定义一个POCO类来表示你的配置：

public class MyCustomSettings
{
    public string SomeKey { get; set; }
    public int Limit { get; set; }
    public bool FeatureEnabled { get; set; }
}

然后在

Program.cs

（或旧版

Startup.cs

）中注册这个配置类，并将其绑定到配置系统的一个特定节：

// Program.cs
builder.Services.Configure(
    builder.Configuration.GetSection("MyCustomSettings"));

现在，你就可以在任何需要的地方注入

IOptions

来获取强类型的配置对象了：

public class AnotherService
{
    private readonly MyCustomSettings _settings;

    public AnotherService(IOptions options)
    {
        _settings = options.Value; // .Value 属性获取实际的配置对象
    }

    public void DoAnotherThing()
    {
        if (_settings.FeatureEnabled)
        {
            Console.WriteLine($"Limit is: {_settings.Limit}");
        }
    }
}

这种方式不仅让代码更清晰，也更容易测试和维护。

ASP.NET Core配置系统为何如此灵活且易于扩展？

ASP.NET Core的配置系统之所以能够做到这一点，核心在于它的提供者（Provider）模型和层次化结构。它不是把所有配置都塞到一个文件里，而是允许你从各种来源拉取信息，并且智能地处理冲突。

首先，提供者模型是关键。你可以把配置想象成一个水库，而不同的配置源就是注入水库的河流。

ConfigurationBuilder

能够注册多个

IConfigurationProvider

，每个提供者负责从特定来源读取配置，比如

JsonConfigurationProvider

读取JSON文件，

EnvironmentVariablesConfigurationProvider

读取环境变量，

CommandLineConfigurationProvider

读取命令行参数，甚至还有

AzureKeyVaultConfigurationProvider

用于从Azure Key Vault获取密钥。这种设计让开发者可以根据需要，轻松地添加或移除配置源，甚至编写自定义提供者来集成任何你想要的配置存储（比如数据库、Consul、ZooKeeper等）。我个人就曾为一些遗留系统编写过从特定XML文件读取配置的提供者，整个过程出乎意料地顺畅。

其次，层次化结构和覆盖机制提供了巨大的灵活性。配置系统会按照你添加提供者的顺序来加载配置。如果多个提供者包含相同的键，那么后加载的提供者的值会覆盖先加载的值。这在管理不同环境的配置时尤其有用。比如，你可以在

appsettings.json

中定义通用设置，然后在

appsettings.Development.json

中覆盖开发环境特有的设置，接着，环境变量又可以覆盖这些文件中的设置。这种“后加载者胜出”的原则，使得配置管理变得非常强大和直观，你不需要修改代码就能适应不同的部署场景，这极大地简化了DevOps流程。

如何有效管理不同部署环境下的应用程序配置？

管理不同环境下的配置，是每个项目都会遇到的实际挑战。ASP.NET Core为这个问题提供了非常优雅的解决方案，主要围绕着环境特定配置文件的使用和环境变量的优先级。

易森网络企业版

如果您是新用户，请直接将本程序的所有文件上传在任一文件夹下，Rewrite 目录下放置了伪静态规则和筛选器，可将规则添加进IIS，即可正常使用，不用进行任何设置；(可修改图片等)默认的管理员用户名、密码和验证码都是：yeesen系统默认关闭，请上传后登陆后台点击“核心管理”里操作如下:进入“配置管理”中的&ld

下载

首先，环境特定配置文件是基石。我们通常会有一个

appsettings.json

文件，包含所有环境通用的默认配置。然后，对于特定的环境，比如开发环境（Development）、测试环境（Staging）或生产环境（Production），我们会创建对应的文件，如

appsettings.Development.json

、

appsettings.Staging.json

、

appsettings.Production.json

。当应用程序启动时，它会根据当前的环境变量

ASPNETCORE_ENVIRONMENT

（或者

DOTNET_ENVIRONMENT

）的值，自动加载并合并对应的环境配置文件。例如，如果

ASPNETCORE_ENVIRONMENT

设置为

Development

，那么

appsettings.Development.json

中的配置会覆盖

appsettings.json

中同名的配置。

这套机制，在我看来，让配置管理变得非常清晰。你可以在开发环境使用本地数据库连接字符串，在生产环境使用云数据库的连接字符串，而无需更改一行代码。它将环境差异性从代码中剥离出来，大大降低了出错的风险。

然而，仅仅依靠文件还不够。环境变量在优先级上是高于配置文件的，这是一个非常重要的特性，尤其是在容器化部署（如Docker、Kubernetes）和云服务（如Azure App Service、AWS Elastic Beanstalk）中。在这些场景下，我们通常不希望将敏感信息（如数据库密码、API密钥）直接写入配置文件并提交到版本控制。相反，我们会将这些敏感信息作为环境变量注入到运行中的容器或应用实例中。由于环境变量的优先级最高，它们会覆盖配置文件中的任何同名设置。这不仅提高了安全性，也让部署更加灵活，因为你可以在不重新构建应用程序的情况下，动态地更改敏感配置。

举个例子，如果你的

appsettings.json

里有

"ConnectionStrings:DefaultConnection": "Server=mydevdb;..."

，但你在部署时设置了一个环境变量

ConnectionStrings__DefaultConnection="Server=myproddb;..."

（注意双下划线

__

是环境变量中表示层级的约定），那么应用程序在运行时就会使用生产环境的连接字符串。这种组合使用文件和环境变量的方式，形成了一个强大而安全的配置管理策略。

使用Options模式有哪些显著优势，以及如何选择IOptions、IOptionsSnapshot和IOptionsMonitor？

Options模式是ASP.NET Core中管理配置的“高级玩法”，它带来的显著优势在于类型安全、关注点分离以及对配置热更新的支持。

类型安全和关注点分离： 这是最直观的优势。通过将配置值映射到强类型POCO类，你不再需要使用字符串键来访问配置，这消除了因键名拼写错误而导致的运行时异常。IDE的智能提示也能让你更方便地找到和使用配置。同时，每个配置类只关注应用中某个特定功能或模块的配置，这符合单一职责原则，使得代码更清晰，更容易维护。想象一下，一个服务只需要知道它需要的
```
EmailSettings
```
，而不需要关心
```
DatabaseSettings
```
，这大大降低了耦合度。
配置热更新： 这是Options模式的一个强大特性，尤其是在分布式系统和微服务架构中。传统的
```
IConfiguration
```
在应用启动后，其加载的配置通常是静态不变的。但有时，你可能需要在不重启应用的情况下，更新某些配置，比如动态调整日志级别、功能开关或API限速阈值。Options模式通过
```
IOptionsSnapshot
```
和
```
IOptionsMonitor
```
提供了这种能力。
- ```
IOptions
```
  ：这是最基本的Options接口，它提供了一个单例的配置实例。一旦应用启动，
```
options.Value
```
  就会被初始化，并且在应用的整个生命周期中保持不变。适用于那些在应用启动后不希望或不需要改变的配置。
- ```
IOptionsSnapshot
```
  ：它提供了一个请求作用域（scoped）的配置实例。这意味着在每个HTTP请求（或每次解析服务）中，都会重新计算并获取最新的配置值。如果底层配置文件（如
```
appsettings.json
```
  ）发生变化，
```
IOptionsSnapshot
```
  会在下一个请求中反映这些变化。这对于Web应用中需要响应配置变更，但又不希望所有组件都订阅变更事件的场景非常有用。我通常在控制器或请求处理服务中优先使用它。
- ```
IOptionsMonitor
```
  ：这是最强大的选项，它提供了一个单例实例，但允许你订阅配置变更事件。这意味着即使在后台服务或长期运行的任务中，你也可以实时地获取最新的配置值，甚至在配置变更时执行一些自定义逻辑。
```
IOptionsMonitor
```
  的
```
CurrentValue
```
  属性会始终返回最新的配置，并且你可以通过
```
OnChange
```
  方法注册回调函数来处理配置更新。当你有一个缓存服务，希望在配置变更时刷新缓存，或者一个后台任务需要根据配置动态调整行为时，
```
IOptionsMonitor
```
  是理想的选择。