如何修复运行ASP.NET Core应用时的Azure.Identity.CredentialUnavailableException

根因说明 #

你遇到的错误链核心原因是本地调试环境未获得Azure App Configuration的访问授权：你开启了服务身份验证但未配置角色分配，Azure Identity SDK无法获取到合法的访问凭证，首先抛出Azure.Identity.CredentialUnavailableException，后续的System.Net.Sockets.SocketException、System.OperationCanceledException都是身份验证请求多次重试失败后触发的超时、操作取消连锁报错，页面无数据是因为应用始终未拉取到配置中心的存储内容。

1. 配置Azure App Configuration访问角色 #

• 登录Azure门户进入对应的App Configuration服务实例
• 左侧导航栏选择「访问控制(IAM)」，依次点击「添加」→「添加角色分配」
• 角色列表选择 App Configuration Data Reader （本地调试仅需只读权限即可拉取配置），点击下一步
• 分配对象选择「用户、组或服务主体」，点击「选择成员」，搜索并选中你用于登录Azure的账号，点击「审核+分配」完成角色配置

2. 配置Visual Studio调试身份凭证 #

• 打开项目对应的Visual Studio 2019，点击右上角账号头像进入「账户设置」
• 确认当前登录的Azure账号和上一步中添加角色分配的账号完全一致，若不匹配请切换为对应账号
• 如果你习惯使用Azure CLI做身份验证，可在终端执行az login命令登录对应账号，Azure Identity库会自动按优先级读取可用的合法凭证

3. 验证修复效果 #

• 清理项目缓存：点击顶部菜单「生成」→「清理解决方案」，再执行「生成」→「重新生成解决方案」
• 重新启动调试，此时身份验证可正常通过，不会再抛出相关异常，页面可正常加载配置数据

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