Azure函数HTTP触发(POST)上传PDF至Blob容器的问题排查

错误原因分析 #

报错System.Private.CoreLib: Exception while executing function: Functions.HttpTrigger1. Microsoft.Azure.WebJobs.Host: No value for named parameter 'filename'.是因为你在Blob输出绑定的path中使用了{filename}占位符，但Azure Functions运行时无法找到该参数的取值——当前函数仅接收HTTP请求，未将上传文件的文件名传递给绑定系统。

推荐解决方案：使用Blob Storage SDK直接上传 #

这种方式更灵活，可完全控制文件名、文件格式，还能避免覆盖已有文件。

1. 修改functions.json #

移除原有的Blob输出绑定，仅保留HTTP触发和输出：

{
  "scriptFile": "__init__.py",
  "bindings": [
    {
      "authLevel": "anonymous",
      "type": "httpTrigger",
      "direction": "in",
      "name": "req",
      "methods": [
        "post"
      ]
    },
    {
      "type": "http",
      "direction": "out",
      "name": "$return"
    }
  ]
}

2. 修改__init__.py代码 #

引入Azure Blob Storage SDK，直接操作Blob存储：

import logging
import os
from azure.storage.blob import BlobServiceClient
import azure.functions as func


def main(req: func.HttpRequest) -> func.HttpResponse:
    try:
        pdf_file = req.files.get("pdf")
        logging.info("已获取上传文件")
        
        if pdf_file:
            pdf_content = pdf_file.read()
            filename = pdf_file.filename
            logging.info(f"读取文件完成，文件名：{filename}")
            
            # 从环境变量读取Blob存储连接字符串（对应原functions.json中connection的配置值）
            connect_str = os.environ["AzureWebJobsStorage"]  # 若原配置使用自定义名称，替换为对应的环境变量名
            
            # 初始化Blob服务客户端
            blob_service_client = BlobServiceClient.from_connection_string(connect_str)
            # 获取目标容器客户端
            container_client = blob_service_client.get_container_client("outcontainer")
            
            # 上传文件，使用原文件名，设置overwrite=False避免覆盖已有文件
            blob_client = container_client.get_blob_client(filename)
            blob_client.upload_blob(pdf_content, overwrite=False)
            
            logging.info("文件上传成功")
            return func.HttpResponse(f"文件上传成功：{filename}", status_code=200)
        else:
            return func.HttpResponse("请求中未包含PDF文件", status_code=400)
    except Exception as e:
        logging.error(f"上传出错：{str(e)}")
        return func.HttpResponse(f"上传失败：{str(e)}", status_code=500)

3. 依赖配置 #

在项目根目录创建requirements.txt，添加SDK依赖：

azure-functions
azure-storage-blob>=12.0.0

备选方案：调整绑定参数（不推荐） #

若坚持使用Blob输出绑定，需让运行时获取到filename参数值，可通过HTTP路由参数传递：

1. 修改functions.json #

给HTTP触发添加路由参数：

{
  "scriptFile": "__init__.py",
  "bindings": [
    {
      "authLevel": "anonymous",
      "type": "httpTrigger",
      "direction": "in",
      "name": "req",
      "methods": ["post"],
      "route": "upload/{filename}"
    },
    {
      "type": "http",
      "direction": "out",
      "name": "$return"
    },
    {
      "type": "blob",
      "direction": "out",
      "name": "outputBlob",
      "path": "outcontainer/{filename}",
      "connection": "你的连接字符串配置名"
    }
  ]
}

2. 修改__init__.py代码 #

在函数签名中添加filename参数：

import logging
import azure.functions as func


def main(req: func.HttpRequest, outputBlob: func.Out[bytes], filename: str) -> func.HttpResponse:
    try:
        pdf_file = req.files.get("pdf")
        logging.info("已获取上传文件")
        
        if pdf_file:
            pdf_content = pdf_file.read()
            logging.info(f"读取文件完成，文件名：{filename}")
            
            outputBlob.set(pdf_content)
            logging.info("文件上传成功")
            return func.HttpResponse(f"文件上传成功：{filename}", status_code=200)
        else:
            return func.HttpResponse("请求中未包含PDF文件", status_code=400)
    except Exception as e:
        return func.HttpResponse(f"上传失败：{str(e)}", status_code=500)

注意：此方案要求客户端请求时在URL中指定文件名（如POST /api/upload/myfile.pdf），无法直接使用上传文件的原始文件名，灵活性较差。

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