使用Python连接字符串上传文件至Azure Blob存储失败问题排查

问题现象 #

使用存储账户连接字符串可成功创建Blob容器，但上传文件时触发ClientAuthenticationError，错误信息显示签名不匹配；使用SAS密钥、Azure门户上传均正常。

排查与解决方法 #

• 验证连接字符串准确性
  确认连接字符串中的存储账户名和访问密钥完全正确，无多余空格或截断。建议直接从Azure门户的「存储账户→访问密钥」页面复制完整连接字符串替换代码中的connect_str。

• 检查Blob命名合规性
  代码中用upload_file_path作为Blob名称，若路径包含特殊字符（如斜杠、空格）可能导致签名计算异常。尝试简化Blob名称（如直接用"dummy_data.xlsx"），确保符合Azure Blob命名规则（长度1-1024字符，允许字母、数字及部分特殊字符）。

• 更新SDK版本
  旧版azure-storage-blob可能存在签名计算bug，执行以下命令升级到最新稳定版：

  pip install --upgrade azure-storage-blob azure-identity
  

• 排查网络代理/防火墙干扰
  若存在代理或防火墙，可能篡改HTTP请求头导致签名验证失败。尝试在无代理环境测试，或确保代理不修改请求内容。

• 显式指定API版本
  创建BlobServiceClient时指定兼容的API版本，避免版本不匹配引发的签名问题：

  blob_service_client = BlobServiceClient.from_connection_string(
      connect_str,
      api_version="2021-12-02"
  )
  

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