使用托管标识访问Azure App Configuration时报端点空值错误如何解决？

架构老林

2026-9-28

问题根因

你的报错日志明确指向System.Uri..ctor(String uriString)触发空参数异常，说明代码第29行执行时settings["AppConfig:Endpoint"]读取结果为null，并不是托管标识凭证的问题。

排查步骤

1 确认配置加载顺序是否正确
你需要先构建已注册的默认配置源（包含appsettings.json、环境变量、应用服务配置等），再读取Endpoint参数配置Azure App Configuration。错误写法通常是未提前执行config.Build()就尝试读取配置值，导致还没加载appsettings.json里的参数就调用了Connect方法。
正确代码参考：
```
webBuilder.ConfigureAppConfiguration((context, config) =>
{
    // 先构建已加载的配置源，才能读到AppConfig:Endpoint
    var settings = config.Build();
    config.AddAzureAppConfiguration(options =>
    {
        options.Connect(new Uri(settings["AppConfig:Endpoint"]), new ManagedIdentityCredential("26e962f7-1a26-4f11-84d4-3bfcdd9f7dcc"));
    });
})
```
2 确认部署到Azure后的配置是否存在
本地appsettings.json的配置不会默认同步到Azure App Service，需要手动在App Service的「配置」-「应用程序设置」中添加键值对：
- 若为Windows托管：键名为AppConfig:Endpoint，值为完整的App Configuration服务地址，格式为https://<你的服务名>.azconfig.io
- 若为Linux托管：冒号需替换为双下划线，键名为AppConfig__Endpoint
3 确认Endpoint格式正确
不要把完整的连接字符串填到AppConfig:Endpoint中，仅需提取连接字符串里Endpoint=后面的完整URL部分，必须带https://前缀。
4 临时验证
可以先把Endpoint硬编码到Connect方法中测试，如果硬编码后服务能正常启动，即可100%确认是配置读取环节的问题，不用再怀疑依赖包或托管标识配置错误。