.NET 6中IConfiguration读取配置时自动替换占位符的实现方法

你的第一种思路可行性更高，不需要重写IConfiguration相关方法、也不需要修改原有配置读取逻辑，完全兼容所有原生配置API，包括第三方组件的配置读取逻辑。具体实现步骤如下：

1. 约定占位符格式 #

首先定义占位符的匹配规则，比如通用的${变量名}格式，示例appsettings.json配置如下：

{
  "ConnectionStrings": {
    "MyDb": "Server=${DbHost};Database=${DbName};Uid=${DbUser};Pwd=${DbPwd};"
  },
  "AppSettings": {
    "UploadPath": "${RootPath}/upload",
    "LogPath": "${RootPath}/log"
  }
}

2. 编写配置替换逻辑 #

在配置全部加载完成后，递归遍历所有配置节点，对叶子节点的 value 做占位符替换后写回内存配置即可。
在Program.cs中添加如下代码：

using System.Text.RegularExpressions;

var builder = WebApplication.CreateBuilder(args);

// 原有服务注册逻辑，无需修改
// builder.Services.Addxxx...

var app = builder.Build();

// 配置加载完成后立即执行占位符替换
if (app.Configuration is IConfigurationRoot configRoot)
{
    ReplaceConfigurationPlaceholders(configRoot);
}

// 原有中间件注册逻辑，无需修改
// app.Usexxx...

app.Run();

// 占位符替换方法
void ReplaceConfigurationPlaceholders(IConfigurationRoot configRoot)
{
    // 递归遍历配置树
    void TraverseConfigSection(IConfigurationSection section)
    {
        var children = section.GetChildren().ToList();
        // 叶子节点执行替换
        if (!children.Any())
        {
            var originalVal = section.Value;
            if (string.IsNullOrWhiteSpace(originalVal)) return;
            
            // 匹配 ${xxx} 格式的占位符
            var replacedVal = Regex.Replace(originalVal, @"\$\{(?<placeholderKey>[^}]+)\}", match =>
            {
                var key = match.Groups["placeholderKey"].Value;
                // 可自定义实际值的来源：比如从环境变量取、从字典取、从当前配置其他节点取
                // 示例1：从当前配置取值
                return configRoot[key] ?? match.Value;
                // 示例2：从环境变量取值
                // return Environment.GetEnvironmentVariable(key) ?? match.Value;
            });
            // 替换后的值写回配置
            section.Value = replacedVal;
            return;
        }
        // 非叶子节点递归遍历子节点
        foreach (var child in children)
        {
            TraverseConfigSection(child);
        }
    }

    // 从根节点开始遍历
    foreach (var rootChild in configRoot.GetChildren())
    {
        TraverseConfigSection(rootChild);
    }
}

3. 效果验证 #

所有原有配置读取逻辑无需做任何修改，调用_configuration.GetConnectionString("MyDb")、_configuration.GetSection("AppSettings:UploadPath").Value等方法时，自动返回替换完成后的实际值。

注意事项 #

• 若存在配置循环引用的场景（A配置引用B、B配置又引用A），可添加替换次数限制避免死循环
• 若开启了配置热重载，可监听IConfigurationRoot.GetReloadToken()的变更事件，配置变更后重新执行一遍替换逻辑即可
• 若需要保留原有的${字符，可在替换逻辑中添加转义规则，比如将\${处理为普通的${字符串

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