Linux环境下AzureCliCredential导入报错如何排查解决

• 运行环境：Linux系统
• 前置操作：已通过az login命令完成Azure账号登录，已执行pip install azure-identity安装SDK依赖
• 异常表现：运行Python代码时，在导入AzureCliCredential环节触发报错，截断的报错回溯信息如下：

Traceback (most recent call last):
File "scan.py", line 1, in 
from azure.identity import AzureCliCredential

• 复现用测试代码：

from azure.identity import AzureCliCredential
from azure.mgmt.subscription import SubscriptionClient
import json


credential = AzureCliCredential()
subscription_client = SubscriptionClient(credential)
sub_list = subscription_client.subscriptions.list()

for sub in list(sub_list):
    subs_id = sub.subscription_id
    print(subs_id)

多次重装依赖后问题仍复现。

1. Python多环境冲突（最高发） #

Linux系统通常自带多版本Python（Python2/Python3、系统Python/虚拟环境Python），直接执行裸pip命令安装依赖时，很可能把包装到了和运行脚本的解释器不匹配的site-packages目录下，导致解释器找不到对应模块触发导入错误。
修复操作：

• 先确认运行脚本使用的解释器路径：如果用python3 scan.py运行脚本，就执行which python3拿到解释器绝对路径；如果用python scan.py就执行which python
• 用拿到的解释器绝对路径重新安装依赖，避免装错环境，比如解释器路径为/usr/bin/python3时执行：

  /usr/bin/python3 -m pip install azure-identity azure-mgmt-subscription --upgrade
  

• 验证导入是否正常：执行/usr/bin/python3 -c "from azure.identity import AzureCliCredential; print('导入成功')"，无报错即环境匹配正常。

2. SDK版本兼容问题 #

早期1.x版本的azure-identity存在Linux平台下的导入路径bug、依赖缺失问题，会直接触发导入报错。
修复操作：
升级SDK到最新稳定版，如果使用虚拟环境请先激活对应虚拟环境再执行命令，全局安装需要管理员权限的话自行加sudo：

pip install --upgrade azure-identity azure-mgmt-subscription

3. 同名文件冲突 #

Python导入模块时会优先读取脚本当前工作目录下的文件，如果运行脚本的目录下存在自定义的azure.py文件、azure/同名文件夹，会覆盖官方安装的Azure SDK包，导致导入逻辑异常。
修复操作：

• 检查脚本所在目录，将自定义的同名azure.py、azure文件夹重命名为非冲突名称
• 删除目录下自动生成的__pycache__缓存文件夹，重新运行脚本即可。

4. Azure CLI本身运行异常 #

AzureCliCredential的逻辑是调用本地Azure CLI的接口拿登录凭证，如果Azure CLI本身运行异常、缺少系统依赖，会触发导入链报错。
修复操作：

• 先验证CLI本身可用性，执行az account show，如果该命令报错，先修复/重装Azure CLI，确保CLI可以正常读取已登录的账号信息
• 最小化安装的Linux发行版可能缺少CA证书包，Debian/Ubuntu系执行sudo apt install -y ca-certificates && sudo update-ca-certificates，RHEL/CentOS系执行sudo yum install -y ca-certificates && sudo update-ca-trust，更新证书后重试。

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