macOS Big Sur(M1芯片)使用DefaultAzureCredential报错问题咨询

DevOps 小满

2026-9-28

解决方案

该场景在M1芯片macOS上完全支持，你遇到的是本地配置问题，可按照以下步骤逐一排查解决：

先验证Azure CLI本身登录有效
打开终端执行命令 az account get-access-token，如果能正常返回token字符串，说明CLI登录状态正常，否则先执行 az login 重新完成登录、选择正确的订阅。
修复Azure CLI路径识别问题
报错中提示「Azure CLI not installed」是因为Azure Identity库找不到az命令的执行路径，M1芯片macOS通过Homebrew安装的Azure CLI默认路径为/opt/homebrew/bin/az，多数GUI IDE默认不会加载用户shell的PATH配置，需要手动配置：
如果使用Visual Studio for Mac运行项目：打开项目设置 -> 运行 -> 配置 -> 默认，在环境变量的PATH值中追加:/opt/homebrew/bin，保存后重启项目即可。
如果使用终端运行dotnet命令：执行echo $PATH确认路径包含/opt/homebrew/bin，缺失的话在对应shell配置文件（.zshrc/.bashrc）中添加PATH配置即可。
简化凭证链减少无效干扰
本地开发不需要DefaultAzureCredential默认的所有凭证校验项，可显式关闭不需要的凭证类型，只保留Azure CLI凭证：
```
var credential = new DefaultAzureCredential(new DefaultAzureCredentialOptions
{
    // 关闭本地开发不需要的凭证类型
    ExcludeEnvironmentCredential = true,
    ExcludeManagedIdentityCredential = true,
    ExcludeVisualStudioCodeCredential = true,
    ExcludeVisualStudioCredential = true,
    ExcludeAzurePowerShellCredential = true
});
```
另外报错中提到的操作系统不支持提示是ManagedIdentityCredential的正常报错，Managed Identity仅适用于Azure云上部署的资源，本地开发不会用到该凭证，不影响CLI验证逻辑。