Docker环境中无法导入BlobServiceClient问题求助

核心原因 #

错误提示中导入路径指向/usr/lib/python3/dist-packages/azure/storage/blob/__init__.py，这是系统自带Python包的目录，说明Docker镜像中存在系统预装的旧版azure-storage-blob，它覆盖了你通过pip安装的12.14.1版本。旧版本的包中没有BlobServiceClient类（该类是azure-storage-blob v12+才引入的）。

另外，Python 3.8.10和azure-storage-blob 12.14.1是兼容的（该版本支持Python 3.7+），所以版本兼容不是问题。

解决步骤 #

1. 确认包安装位置冲突 #

先在Docker容器内执行以下命令，查看pip安装的包路径：

pip show azure.storage.blob

如果输出的Location是/usr/local/lib/python3.8/site-packages，但导入时却用了/usr/lib/python3/dist-packages的文件，说明系统包优先级更高，导致冲突。

2. 卸载系统预装的旧版包 #

如果是Debian/Ubuntu系的Docker镜像，执行命令卸载系统自带的azure存储包：

apt-get remove -y python3-azure-storage-blob

（如果是其他系统镜像，用对应包管理器卸载，比如yum）

3. 重新安装指定版本的包 #

执行强制重新安装命令，确保包安装到pip的site-packages目录：

pip install azure-storage-blob==12.14.1 --force-reinstall

4. 可选：指定用户目录安装（避免权限或路径冲突） #

如果不想修改系统包，也可以用--user参数将包安装到用户目录，该目录在Python的sys.path中优先级高于系统目录：

pip install azure-storage-blob==12.14.1 --user

5. 验证修复 #

进入Python交互环境测试导入：

from azure.storage.blob import BlobServiceClient
print("导入成功")

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