ASP.NET Core健康检查如何从appsettings.json读取配置的URL？

数据老陈

2026-10-3

你之前的写法不生效的核心原因是Configuration.GetSection()返回的是IConfigurationSection类型实例，而AddUrlGroup方法的第一个入参要求接收Uri/字符串类型的目标地址，类型不匹配自然无法正常读取配置。

方案1：直接读取单个指定URL

直接通过索引器读取配置值传入即可：

services.AddHealthChecks()
    .AddUrlGroup(
        new Uri(Configuration["HealthCheckUrls:TestUrl"]),
        "TestUrl"
    );

如果要读第二个地址，把配置键换成HealthCheckUrls:TestUrl2即可。部分版本的健康检查扩展包支持直接传入字符串格式的URL，不需要显式转Uri，写法可以简化为：

.AddUrlGroup(Configuration["HealthCheckUrls:TestUrl"], "TestUrl")

方案2：批量读取所有配置的URL

如果后续可能新增更多健康检查地址，可以直接把整个配置节点转成字典批量注册，不用修改业务代码：

// 读取整个HealthCheckUrls节点为字典
var urlDict = Configuration.GetSection("HealthCheckUrls")
    .Get<Dictionary<string, string>>();

if (urlDict != null)
{
    var healthCheckBuilder = services.AddHealthChecks();
    foreach (var (urlName, url) in urlDict)
    {
        // 空值过滤避免启动报错
        if (!string.IsNullOrWhiteSpace(url))
        {
            healthCheckBuilder.AddUrlGroup(new Uri(url), urlName);
        }
    }
}