执行az extension add安装serviceconnector-passwordless扩展时Pip报错3221225477

问题背景 #

执行az extension add --name serviceconnector-passwordless时触发Pip错误码3221225477，该错误对应Windows系统的访问违规，大概率是CLI自带Python环境与扩展依赖冲突，或是权限不足导致的文件写入问题。

解决步骤 #

1. 查看详细错误日志 #

添加调试参数重新执行命令，定位具体失败节点：

az extension add --name serviceconnector-passwordless --debug

从输出日志中排查是哪个依赖包安装失败，或是哪一步触发了访问权限问题。

2. 清理缓存后重新安装 #

• 若之前尝试安装过该扩展，先删除可能损坏的扩展目录：

  rmdir /s /q "C:\Users\NicholasNamacha.azure\cliextensions\serviceconnector-passwordless"
  

• 清空Pip缓存：

  "C:\Program Files\Microsoft SDKs\Azure\CLI2\python.exe" -m pip cache purge
  

• 重新执行扩展安装命令：

  az extension add --name serviceconnector-passwordless
  

3. 以管理员权限运行命令行 #

右键点击命令提示符，选择「以管理员身份运行」，再执行安装命令，避免因权限不足导致文件写入失败。

4. 切换低版本Python环境尝试 #

CLI自带的Python 3.12.8可能与该扩展存在兼容性问题，若本地有Python 3.11或更低版本：

• 假设本地Python 3.11路径为C:\Python311\python.exe，先设置CLI使用该环境：

  set AZURE_CLI_PYTHON_EXE=C:\Python311\python.exe
  

• 再次执行扩展安装命令

5. 重装Azure CLI修复环境 #

尽管当前CLI显示已是最新版本，重装可修复潜在的环境损坏问题：

• 卸载现有Azure CLI，重新下载最新版本完成安装
• 安装完成后再次尝试添加目标扩展

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