Azure App Services中FastAPI应用无法实例化BlobServiceClient

可能原因及排查方案 #

• 连接字符串配置问题
  本地Jupyter可能直接使用硬编码或本地环境变量的连接字符串，但部署到App Services时，必须在配置 > 应用程序设置中添加CONNECTION_STRING的键值对，代码中要用os.getenv("CONNECTION_STRING")读取环境变量，不能直接写死字符串。检查App Services的应用设置里是否正确配置了这个变量，值是否和本地使用的一致。
• 依赖包未正确安装
  登录App Services的Kudu控制台，进入站点目录后运行pip list，确认azure-storage-blob的版本是12.13.1。如果版本不对或缺失，重新部署时确保requirements.txt被正确识别，部署过程中没有安装错误。
• 权限配置错误
  如果用连接字符串，确认字符串里的账户密钥有效，未过期或被撤销；如果用托管身份，要在存储账户的访问控制(IAM)中给App Services的系统分配身份添加存储Blob数据读取者权限。
• 参数传递错误
  get_blob_client的第一个参数是容器名称，第二个是Blob的路径。检查你的path参数是不是容器名，如果path是包含目录的Blob路径，要调整为blob_service_client.get_blob_client(container="容器名", blob="path/processed.csv")，避免参数混淆导致实例化失败。
• 网络防火墙限制
  查看存储账户的防火墙设置，如果设置了仅允许特定网络访问，要把App Services的出站IP地址添加到白名单里；测试阶段可以临时开启“允许所有网络访问”来排查是否是网络问题。

调试方法 #

在FastAPI代码里添加日志输出，打印关键参数和异常信息，方便定位问题：

import os
import logging
from azure.storage.blob import BlobServiceClient
from fastapi import FastAPI

app = FastAPI()
logging.basicConfig(level=logging.INFO)
logger = logging.getLogger(__name__)

@app.get("/debug-blob")
async def debug_blob():
    conn_str = os.getenv("CONNECTION_STRING")
    logger.info(f"连接字符串已获取: {conn_str is not None}")
    try:
        blob_service_client = BlobServiceClient.from_connection_string(conn_str)
        logger.info(f"BlobServiceClient实例: {blob_service_client}")
        # 替换成你的容器名和Blob路径
        blob_client = blob_service_client.get_blob_client(container="你的容器名", blob="processed.csv")
        return {"状态": "成功", "客户端信息": str(blob_client)}
    except Exception as e:
        logger.error(f"错误信息: {str(e)}")
        return {"状态": "失败", "错误详情": str(e)}

部署后通过App Services的日志流查看输出，就能知道具体哪里出问题了。

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