Azure Automation Runbook中azure.keyvault的secrets模块导入错误如何解决

核心原因 #

• 新版azure-keyvault SDK调整了包结构：secrets不再作为顶级属性暴露在azure.keyvault命名空间下，而是独立的azure.keyvault.secrets子包
• Azure Automation Runbook默认环境可能预装了旧版本Azure SDK包，和你动态安装的版本产生冲突
• 动态安装包后的路径重载逻辑未完全生效，导入时优先读取了预装的旧版azure.keyvault

具体修复步骤 #

1. 调整依赖安装命令 #

新版Azure Key Vault SDK拆分了不同功能的独立包，不要安装通用的azure-keyvault元包，直接安装目标功能包，同时指定安装到用户目录适配Runbook的权限和路径规则：

output = subprocess.run(
    [sys.executable, "-m", "pip", "install", "--user", "azure-identity", "azure-keyvault-secrets"],
    capture_output=True,
    text=True
)
# 打印安装日志方便排查
print("安装标准输出：", output.stdout)
print("安装错误输出：", output.stderr)

2. 修正导入语句 #

不要从azure.keyvault导入secrets，直接使用完整子包路径导入：

# 导入整个secrets模块
import azure.keyvault.secrets as secrets
# 或者直接导入需要的类
from azure.keyvault.secrets import SecretClient

3. 优化路径加载逻辑 #

手动把用户包路径加到系统路径最前面，保证优先加载你新安装的版本：

import sys, site
sys.path.insert(0, site.getusersitepackages())
from importlib import reload, invalidate_caches
reload(site)
invalidate_caches()

4. （可选）清理旧版本冲突 #

如果仍然报错，安装前先卸载预装的旧版本相关包：

subprocess.run(
    [sys.executable, "-m", "pip", "uninstall", "-y", "azure-keyvault", "azure-common"],
    capture_output=True
)

完整可运行示例代码 #

import subprocess
import sys
import site

# 卸载旧版本冲突包（可选）
subprocess.run(
    [sys.executable, "-m", "pip", "uninstall", "-y", "azure-keyvault", "azure-common"],
    capture_output=True
)

# 安装依赖
output = subprocess.run(
    [sys.executable, "-m", "pip", "install", "--user", "azure-identity", "azure-keyvault-secrets"],
    capture_output=True,
    text=True
)
print("安装标准输出：", output.stdout)
print("安装错误输出：", output.stderr)

# 调整路径优先级
sys.path.insert(0, site.getusersitepackages())
from importlib import reload, invalidate_caches
reload(site)
invalidate_caches()

# 导入模块
from azure.identity import DefaultAzureCredential
from azure.keyvault.secrets import SecretClient

print("模块导入成功")

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