运行中Program.cs出现Uri为空的ArgumentNullException问题求助

问题现象 #

ASP.NET Core应用启动正常，但运行过程中调用API时偶尔抛出异常：

Value cannot be null. (Parameter 'uriString')

堆栈信息指向Program.cs中创建Uri的代码，该代码通过读取配置Urls:ResourceUrl设置HttpClient的BaseAddress，使用IHttpClientFactory注入创建实例。

原因分析 #

1. 代码中使用!强制断言配置值非空，但实际运行时Urls:ResourceUrl可能为空（比如配置加载失败、动态刷新后值丢失）。
2. IHttpClientFactory的配置委托（AddHttpClient的第二个参数）是在第一次创建对应名称的HttpClient实例时才执行，而非应用启动阶段，因此启动时不会报错，直到首次调用CreateClient("ResourceUrl")才触发异常。

解决方案 #

1. 启动阶段提前校验配置 #

在注册HttpClient之前，先检查配置值是否有效，提前抛出明确错误，避免运行时突发异常：

// Program.cs
var resourceUrl = builder.Configuration.GetSection("Urls:ResourceUrl").Value;
if (string.IsNullOrWhiteSpace(resourceUrl))
{
    throw new InvalidOperationException("配置项 Urls:ResourceUrl 不能为空，请检查appsettings.json或环境变量");
}

builder.Services.AddHttpClient("ResourceUrl", 
    c => c.BaseAddress = new Uri(resourceUrl));

2. 结合IOptions绑定强类型配置（更灵活） #

如果需要支持配置动态刷新，或希望通过强类型管理配置，可以在HttpClient配置委托中校验：

// Program.cs
// 绑定强类型配置
builder.Services.Configure<BaseConfiguration>(builder.Configuration.GetSection("Urls"));

// 注册HttpClient时从IOptions获取配置并校验
builder.Services.AddHttpClient("ResourceUrl", (serviceProvider, client) => 
{
    var baseConfig = serviceProvider.GetRequiredService<IOptions<BaseConfiguration>>().Value;
    if (string.IsNullOrWhiteSpace(baseConfig.ResourceUrl))
    {
        throw new InvalidOperationException("配置项 Urls:ResourceUrl 不能为空");
    }
    client.BaseAddress = new Uri(baseConfig.ResourceUrl);
});

3. 延迟HttpClient实例创建时机 #

避免在服务构造函数中提前创建HttpClient实例（如示例中的ResourceUrl = _factory.CreateClient("ResourceUrl")），改为在实际调用API的方法中创建，同时添加异常捕获：

// ServicesA.cs
public async Task<HttpResponseMessage> CallResourceApi()
{
    try
    {
        var client = _factory.CreateClient("ResourceUrl");
        return await client.GetAsync("/api/data");
    }
    catch (ArgumentNullException ex)
    {
        _logger.LogError(ex, "调用资源API失败：配置Url为空");
        // 抛出业务异常或返回默认值
        throw new ApplicationException("资源服务配置异常", ex);
    }
}

关键注意点 #

• 禁止依赖!强制断言配置值非空，必须显式做空值检查。
• IHttpClientFactory的配置委托执行时机是首次创建Client时，启动阶段校验能更早发现配置问题。
• 强类型配置（IOptions）更便于多环境配置管理和维护。

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